leploy WinForms 
on the Web 



visualstudiomagazine.com 




www.visualsiudiomagazine.com ^^1^^ 




A FAWCETTE TECHNICAL PUBLICATION 



September 1 , 2002 



VOL.12, NO. 10 



Magazine 




■NEf 



Modify Table Sclpmas 
Programmatically 
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Templates 




Prevent Deqdiocics 
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Only One Suite Has It All, & More 



Infragistics - formed by the merger of Sheridan and ProtoView 



One comprehensive suite offering - infragistics NetAdvantage Suite 1.2 

Infragistics proudly presents an unprecedented range and depth of presentation-layer controls-UltraSuite, UltraWinSuite 
and UltraWebSuite-in one offering. The NetAdvantage Suite is the ONLY fully integrated suite you'll ever need to create 
the most flexible, advanced applications for any Microsoft environment. We provide high-performance, superior tools; 
Grid, Scheduling, Charting, Toolbars, Menus, Tree, Ul and Editing Components and more, in COM, Windows Forms (for 
Visual Studio.NET) and Web Forms (for ASP.NET). 

Tomorrow's architecture, today. WeVe planned our components carefully, applying Infragistics' 
famous Best Practices methodology for highest reliability. Our architected approach to building components is elegant 
and mature; delivering shared assemblies, a unified Ul framework, reusable objects, and transferrable knowledge gained 
from our consistent object models. Shared assemblies (such as our exclusive Presentation Layer Framework) mean 
common behavior and programmability across more efficient controls. Yet, we've maintained maximum flexibility, 
superior interface design, database compatibility and advanced out-of-box conveniences such as RAD designers. 

(Smaller investment + Bigger Suite) - Activation = Easy Math 



Infragistics Products 

NetAdvantage Suite v1. 2 $ 

NetAdvantage Suite v1 .2 with annual subscription $ 
NetAdvantage Suite v1 .2 Enterprise Edition $ 



495 

695 (includes source code) 

995 (includes source code) 
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UltraWebListBars 

O UltraWebNavigatprTree 

UltraWebTabs 

O NEW UltraWebGrid 

O NEW UltraWebChart 

UltraWinSuite 

O UltraWinListBar 

O UltraWinTree 

® UltraWinCrid 

(D UltraWeekView 

© UltraMonthViewMuIti 

® UltraDayView 

© NEW UltraWinChart 

Infragistics Presentation 

Layer Framework 

Sampling of fully 

customizable UlElements 

A ItemUIEIement 

ItemlmageUIEIement 

GroupByRowUIEIement 

^ CroupByButtonUIEIement 
^ DayofWeekUIEIement 
A WeekUIEIement 
A NodelmageUIEIement 
A ExpanslonUIEIement 
A RowUIEIement 
A DayNumberUIEIement 
* AppointmentUIEIement 



We've Added WebGrid & Charting! 

Infragistics NetAdvantage^" Suite 1 .2 includes the following: Jj 



UltraWinSuite™ 1.1 

Windows Forms 

Rich Client Components for 

Visual Studio .NET 

■ UltraWinCrid™ 

- UltraWinTree™ 

- UltraWinSchedule™ 

- UltraWinListBar™ 

- NEW UltraWinChart™ 

- UltraWinToolBars™* 



UltraWebSuite™ 2 

Web Forms Components for 
ASP.NET 

. UltraWebBars™ 

■ UltraWebNavigator™ 

- UltraWebCrid™ 

- NEW UltraWebChart™ 

* scheduled for version 2 release. Purchase 
NetAdvantage Suite i.2 with Subscription 

or Enterprise, and receive version 2 

automatically, for FREE 



UltraSuite™ 3 

ActiveX Components 

- UltraCrid™ 

■ UltraToolBars™ 

- ActiveTreeView™ 

- ScheduleX^" 

■ DataExplorer™ 

NetAdvantage Suite is available with optional 
subscription or Enterprise Editions. 



Maximize your efficiency. Minimize your code. Sacrifice nothing. 




Powerea 

resentatloi^ 

layer 

mework" 



Visit www.infragistics.com 

Read the Presentation Layer 
Framework white paper 
www.infragistics.com/netwinforms 

Download Free Trial Version! 
Order Online! or call 800-23 1 -8588 



nfragistics^^ 

Component powered infrastructure 



Copyright 2002 Infragistics. Inc A]| rights reserved. Infragistics. the Infragistics logo, the Presentation Layer Framework logo, NetAdvantage, UltraSuite, Ut&aVMnSuite, UNiaWinCrid, UftraWinTree, UltraWinSchedule, UttraWinTooiBars, UltraWinLtstBai; UltraWinChart, 
UltraVMiSuite, LUtraWebBars, UltraVlfebNavigator UltraWebCrid^ UltraV\febChart. Data Exptorer. ActiveTreeView, UltraCrid, UltraToolBars, ScheduleX ate tradernarks of infragistics, inc. All other trademarks or registered trademarks are the respective pnDperty of their owners. 



800-231-8588 « infragistics.com 
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Chart FX. 

customers 



SoftwateFX 

Any Chart, Anywhere! 



Chart FX for .NET 



Rewritten in C# to exist within .NET as managed co> 

Now, your entire 
'ET charting solution... 
in one package! 

rtFXfor.NET Web Forms 
Production Server license 
Unlimited CPUs per license 

• 1 Development Server license 

;o includes... 

chart FX for .NET Windows Fbnns* 

• 1 Server license 

* Chart FX for .NET is also available 
in a Windows Forms only package. 

See web site 

for pricing. 



▼ NET 



I JJpJU; Chart FX for Web Matrix | 
1 NtW. Basic charting for the Microsoft 
j |v Web Matrix development tool. 
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Chart T)ip«: 



Resource Center 

An interactive programmer's guide that 
integrates a comprehensive explanation 
of the different features and hundreds 
of samples in different languages, 
Including C# and VB.NET 



Awizard 

The Wizard will appear, when a chart 
is dropped into a Windows or Web 
Form, and assist in creating visually 
stimulating, useful charts before writing 
a single line of code. 



B Chart FX 

FREE .NET Charting 




Get the FREE charting solution for Windows 
Forms created with Visual Studio.net. Chart FX 
Lite offers valuable charting functionality, 
including royalty-free distribution; 2D & 3D 
charts: grid line & axis manipulation; ability to 
pass data through the API or DataSets; forward 
code compatibility for easy migration,, 
to other Chart FX products. 

Download 



it 



• Buy Online! 

• Not Ready to Buy? 

Download fully-functional trial versions. 

• Catalogs and Demo CDs! 

Request a catalog or demo CD be shipped 
to you in the U.S.— absolutely FREE! 

• Quality Sufjport! 

support.softwarefx.com offers FREE 
online access to hundreds of Knowledge 
Base articles, FAQs, newsgroups and 
product patches and updates downloads. 
Support subscriptions available as well. 




(561) 999-8888 • www.softwarefx.com • (800) 392-4278 




©2002 Software FX, Inc. Ad rights reserved Chart FX is a registered trademark of Software FX, Inc. 
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Hyltlbclay.forneel 

Download a Trial at www.softwarefx.com 
or call (561) 999-8888 for your demo CD. 



SoftwareFX \ 




Product Catalog 
or Demo CD 

BEE WEBSITE FOn 



Chart FX Internet 5.5 




The most advanced charting solution for Internet developers. 

chart FX Internet powerful features: 
Interactive Image Map Generation 
Drill-Down Capability 
Object Oriented API 
Auto Browser Detection & Response 
User Interface for Edit and Customization 
Bit-Streaming Directly to a Browser 
(required for web farms) 
ActiveX and Netscape Plug-Ins Included 
Dynamic Template and Code Generation 
(ASP ColdFusion or Client-Side Code) 
Included DTC (visual InterDev 6.0 compliant) 

Embedded Data Binding 
Highly Extensible (Annotation. CrossTab. XML) 

Included Sample Code & KnowledgeBase 
Included Wireless Extension 

Scalable Vector Graphics Generation 
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Chart FX Client Server 5.1 ''^^'fiS 

The industry leading charting tool - now embedded! 

The most feature-rich client server 
wchitecture charting component available: 

Convenient Wizard Setup 
User Interface for Easy Control 
Easily Accessible API 
. Active Document Server (OLE Server) 

• Dynamic Template and Code Generation 

• Integrated Annotation Extension 

• Included Sample Code & KnowledgeBase 

Pocket Chart FX Included! 

• Familiar Chart FX API 

• Works with eVB and eVC++ 

• Pre-compiled formats (MIPS, arm, sh3/4) 

• ADO-CE support 

• Customizable stylus events 

• Most 2D & 3D Chart FX charts supported 

• Less than 400K memory footprint 




Chart FX Real-Time 

Embedded real-time capabilities 
for Internet/intranet applications. 

Chart FX Maps 

Dynamic, data-driven image 
generation for .NET developers. 

Chart FX for Java 

Chart FX for the J2EE application 
server environment. 


\mage Toppings 

Dynamic, data-driven 
image generation. 

(iTSRV) Pronn 


WebBar FX & 
WebTree FX 

Enhanced information 
architecture & organization. 

(WTFX or WBFX) ^ " " 



Chart FX Financial 

Powerful Technical Analysis 
charting for financial providers. 




Some of the financial features are: 

• 4 New Japanese Charts 

• 50+ Studies to enhance chart analysis 

• Up to 18 user defined indicators, 
calculated by the programmer 
and displayed as a technical or 
price indicator 

• Up to 3 Technical Indicators in a 
single screen 

• 12 Custom Interactive Drawing features 
(i.e. Fibonacci Fans, Arcs, etc.) 

(CFXFE) " ' 
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Chart FX Wireless 




Develop robust 
wireless apps 
with powerful 
charting 
capabilities. 

(CIE55ALP2) 
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(561) 999-8888 • www.softwarefx.com • (800) 392-4278 
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Every developer dreams of that one tool that 
you can't live without. You crave the tool 
that will fill all of your development needs. 
It's real. It's here. It's ComponentOne Studio. 
The complete solution that provides you 
with a variety of ActiveX' components and 
support services that give you all you'll 
ever need for powerful, enterprise wide 
application development. 

ComponentOne Studio is our award-winning 
comprehensive ActiveX subscription that 
provides unsurpassed business value by 
delivering the latest ActiveX components, 
updates and upgrades, new software offerings, 
and e-mail and online support for one 
full year from your date of purchase. 
ComponentOne Studio Is the absolute best 
way to get your tools of choice for Microsoft^ 
Visual Studlo<i development. 



The heart of ComponentOne Studio is It's set of top-notch, award-winning components that 
ComponentOne is legendary for. Below Is a list of the components you'll receive with our 
"ultimate survival tool". 



Grid Components 

• VSFIexGrid® Pro 7.0 

• True DBGrid^' Pro 7.0 

Reporting Components 

• VSVIEW* 7.0 Classic Edition 

• VSVIEW^ 7.0 Reporting Edition 

Charting Components 

• ComponentOne Chart ' 7.0 

• ComponentOne WebCharf 7.0 



Subscription Benefits 

• Free updates and upgrades: Automatically get all updates and upgrades for flU 
components In ComponentOne Studio for one year from your date of purchase. 

• New ActiveX Releases: Get any new ActiveX components that we release during the 
term of your subscription. 

• Free e-mail support: Receive e-mail support for one year from your date of purchase. 



Data Components 

• ComponentOne Query " 1.0 

• ComponentOne True DBList " Pro 7.0 

• True DBInput " Pro 6.0 

• True DataControl ■ 6.0 

User Interface Components 

• SIzerOne ' 7.0 

• VSFORUM- 2.0 

• VSSPELL " 6.0 International Edition ^ 



Visit www.componentone.com/studio to download your eval today! 



$399.95 Upgrade Price $499.95 Full Price 



www.componentone.com '^^^ 

G0lliP0lieil1b«n« 1.800.858.2739 or 1.888.228.4839 'Wij--- 



!) 2001-2002 ComponentOne LLC. All rights reserved. All product names are owned by their respective holders. 
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Debug VS.NET 
Applications 

vs. net's debugging tools 
can help you solve a variety 
of debusing problems. See 
how to use these tools, 
along with various problem- 
solving techniques, to solve 
even the thorniest 
debugging issues. 

by Nancy Folsom and 
Kathleen Dollard 



f; C++ Exceptions 
-: O Common Language RUnHRie ^ 

+ O .^Script Exceptions 
7€ 9 System 

O System. AppOomanUrdoddetSxcepUon 

• System. AppScationException 

9 System.ArgisnentCxception 

O System.ArgumentNiiExcBpHen 

O System.ArgumentOutOfRangeExcapOon 

O System.AHthmedcExcepQon 

4 System. ArrayTypeMematdiExceptton 

4 System. BadlmageFonnatExc^ition 

4 System. CanrotiJnk>adAppDomainCxcef)tk)n 

9 System.ContextKarshalBcception 

O System.Div)deBy2eroExcepUon 

9 Sv^tMn.mNntFn rvFxm'Avi 

When tfiB encBpUon fa thrown! ~ ~ 

f~ SFM^IFtoJtt|9|HM||gw 
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Getting Started 

Manage Contacts With Outlook and VB 

Access Outlook's object model from VB6 
to create and maintain contacts lists, 
by Stan Schultes 
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ok Contacts Maintenace Utility 



Name: Charkrtte Coopw, Email: Chak)tte.Coopet@ExobcLiquids.coni 

Name: Shel^ Be ke. Emai: Shefl^-Butke@NewOrleansCa|ijnDdighes.com 

Name: R^ina Mwphy, Em^ RegiriaML>phy@GiarxlrTialCeiysHomesteadcom 

Name: YosH Nagase, Emai YoshLNagase@TokyoTtad«s.com 

Name: Antonio del Vafle Saaveda, Emal: Antonio-Saayedta@CDopera^adeQue{. 

Name: Mayuni Ohm, Emai: Ma(PuniOhno@Mayuns.com 

Name: Ian Deving. Emal: larLOeving@PavlovaLtdcQm 

Name: Peter Wlson.Emd Peter.Wisan@SpecialtjfiisciiteLtdcom 

Name: Lars Peterson. Em^ L^ls.P^erson@P6ICnaclcebrbd^B.com 

Name: Catbs Diaz, Email: Cabs.Diaz@RefTescosAmeiica»sLTDA.cam 

Name: PettaWinklet, Email: Petra.Wirikler@HdBiiBwarenGmbHCoKG.com 

Name: Martin Bwi, Email: Martin.Bein@Pliit2erLebensmiKel^oflmakteAG.com 

Name: Sven Petersen, Email: SveaPetersen^Nord-Ost-FiscfiHandelsgesellschrft - 

Name: Elio Rossi. Email: Elio.Rossi@FormaggiFoitinisrl.com 

Name: Beate Vileid, Email: Beate.Vrleid@NofskeMeierier.com 

Mame: Cheryl Saiilor, Email; Cheryl,Savlor@BiglootBreweries.com 



Delete Contacts -; UstCwaacls Add Contacts 
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Visual Studio Magazine Article Index 

Check out our comprehensive list of every article ever 

published in VSM. After you search the keywords for a 
topic you're interested in, you can read the related article 
for free on our Web site (vsrww.visualstudiomagazine.com) 
by typing in the associated Locator+ code. 
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What BEA WebLogic Workshop will do for your future. 

If you want your Web services to work across and beyond your enterprise, .NET is just the start. To 
interface with the overwhelming majority of J2EE, host and legacy applications, you need BEA 
WebLogic Worl<shop, the new development f rameworic that helps you create Web services - fast. 
You'll also have all the support of our dev2dev developer community. Give yourself unlimited 
opportunities and open doors that .NET alone can't. Download BEA WebLogic Workshop today 
at htt|:^?/i(^2dev.bea.com/tryworkshop. 

The fastest route to enterprise Web services. 

BEA and WebLogic are registered trademarks, and BEA WebLogic Worl<slnop is a trademark of BEA Systems, Inc. ® 2002 BEA Systems, Inc. 
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Desktop Developer 
Deploy WinForms on the Web 

Marry the deployment advantages of Web applications with the 
rich user experience and security of Windows applications. 

by Mauro Sant'Anna 
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Keep a Window Visible 

Our Q&A columnists show you how to prohibit users from 
moving windows offscreen, use unsafe code the right way, work 
with unchecked code, and declare constant object variables. 

by Karl E. Peterson, Juval Lowy, and Mattias Sjogren 
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ASP.NET 

Create Boilerplate Templates 

Building a boilerplate template saves you time and 
repetition. Create your own project item template to 
customize the code VS.NET creates for Web Forms, 
by Jonathan 
Goodyear 
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Database Design 

Manipulate Schema Information 

ADO.NET doesn't provide classes for schema 
manipulation, but you can modify schemas 

programmatically. Find out your three schema 
manipulation options and when to use each one. 

by Dino Esposito 
58 

Black Belt 

Sync Threads 
Automatically 

Use automatic thread 

synchronization to 
prevent deadlocks and 
simplify the 
management of .NET 
component 
concurrency. 

by Juval Lowy 
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The first rule of intelligent Microsoft .NET development is 
having the right parts. 



Data Components 



User Interface Components 



Charting Components 




Grid Components 



We've got that covered. 



Reporting Components 
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Visit Visual Studio Magazine online to read these exclusive articles and more: 



Create Localizable 
Web User Controls 

Loeator+ code: 
VS0209GV T 

International-aware Web 
controls can reach our to foreign 
markets. Create a Date Picker 
Web control that supports 
different cultural settings, 
by Gerardo Villeda 














] D3tePicket5trinas,tes 























Increase 
Availability and 
Performance 
With Threads 

Locator+ code: VS0209EG_T 

Delve into this set of proven best practices for 
multithreading in VB.NET. Master these and 
find your code running faster and cleaner, 
by Edward G. Nilges 



Locator+ Defined 




you'll 



Go Online! 




Type in this Lacatar+ code to download the code 
for this particular article. You can also get the 
code for this article by pulling up the article 
itself, then clicking on the link to the 
accompanying code. 

Type in this Locator+ code to discuss this article 
with the author and other readers in VSM's 
online discussion forums. 

This Locator+ code brings up the article itself, 
along with any code listings, sidebars, and other 
extra content that wouldn't fit in the printed 
edition of the magazine. 

This Locatar+ code brings up a past article on a 
related topic. 




Use these Locator+ codes at 
www.visualsttidiomagazfne.com 
to go directly to these related resources. 

Download 

VS0209GV Download the code for this article, 
Discuss 

VS0209GV_D Discuss this article in the 
ASP.NET forum. 

Read More 

VS0209GV_T Read this article online. 

VB9807GS_T Getting Started, "Store 
Language Strings in a Resource File," by 
Chris Barlow 



Oracle Provider 
for . NET Extends 
ADO.NET 

Locator+ code: 
VS0209LT_T 

KSAf interviews George 
Demarest, Oracle's director of 
database marketing, on what 
Oracle is doing for .NET 
developers — and how Microsoft could help, 
by Lee The 

Locator+ code: VS0209TT_T 

Check out these helpftd .NET tips and tricks 
from VSM authors: 

• Change VS.NET Keyboard Mappings 

by Dianne Siebold 

• Use the Marker Interface Pattern 

by Matties Sjogren 

• Make the Most of VS.NET's Start Page 

by Juval Lowy 

• Page and Sort Resultsets With ASP.NET 

by Mauro Sant'Anna 

• Optimize VB.NET Code Performance 

by Francesco Balena 

• Tag Your Objects to Anticipate Change 

by Edward G. Nilges — — — ^ 

U the NETInsight^-"^^ 
Every week, the . d^te news, 

„eWsletterbrir.gs7--»P i,,er- 
.echnicalinformano- P> .^e.K- 
views.a.danalys^on^P .^^^B^ic 

•^^^kS St Servers, wireless 
I yreeatwww.visuai ^ 
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Use FarPoint's Spread 6 to easily incorporate 
advanced grid and high-level spreadsheet 
features into your applications. You get 
unmatched flexibility at the cell level for 
maximum control over the display and 
entry of the data, plenty of events to 
respond to user changes and an impressive 
feature list for everything in between; 
including import/export capabilities, 
enhanced printing, 13 cell types, formulas, 
plus many more features you'd expect from 
the market-leading component. 

/NEWI 

V Display multiple row or column headers 
xNEWI 

V Merge cells that contain identical data for easier 
viewing 

,(MPROVEDI 

■</ Use any of the 1 3 cell types, including the new 

percent, to format the entry of the data 
/NEW! 

V Define cell spans in the header and data rows 

Attach cell notes to any cell to display additional 
information about its contents 
/Hem 

V Automatically change the color of negative 
numbers to red 

y Use the border styles to highlight an individual 

cell or a block of cells 
/IMPROVED! 

V Use the Spread Designer to facilitate rapid 
development using its' point-and-click design- 
time interface 

^ Use the Print Preview control to see how your 
printed spreadsheet will look 

Users can sort by clicking column headers using 
built-in sort 

/ Bind the spreadsheet to ActiveX Data Objects 
(ADO) 2.0 using OLE DB technology, Data Access 
Objects (DAO) and Remote Data Objects (RDO) 



FARP&NT 

TECHNOLOGIES INC 
www.farpoint.biz 

1-800-645-5913 



Premier developer and supplier of 

yNeb Form, Win Form and COM Components 



ww.faroomt.bii 



Goin' Mobile With MMIT 



The Microsoft Mobile Internet Toolkit (MMIT) is to the 
impending Compact Framework what ASP/ASP.NET is 
to desktop Visual Studio development. That's a good 
thing for you as a developer. Microsoft actually groups MMIT 
underASP.NET. Like ASP andASP.NET, MMIT depends on 
server-based extensions interacting with IIS to kick down HTML 
to browsers on portable devices, whether Pocket PC devices, 
Palm OS devices, or Web-enabled mobile phones. 

This has all the pluses and minuses you'd expect. The Com- 
pact Framework lets you create standalone applications that 
you install and run on portable devices such as Pocket PC, 
Pocket PC Phone, and the upcoming Smartphone, whereas 
MMIT requires that your device have an active connection to 
the Internet before you can use an MMIT-based application. It 
also goes without saying that you can create far richer applica- 
tions using the Compact Framework on Pocket PC and related 
devices than you can using HTML through a browser — much as 
you can create richer standalone apps on Windows than going 
through a Web interface. 

The biggest drawback to the Compact Framework is that it 
targets Pocket PC and related devices exclusively. You can't tar- 
get Palm devices with it, and you can't target mobile phones that 
aren't Pocket PC-enabled. That's significant because Sun and its 
various Java partners have done a much better job getting Java 
into mobile phones and other mobile devices than Microsoft has 
to date. You can already buy Java-enabled phones from Nokia, 
Motorola, and many others. Meanwhile, Microsoft's Compact 
Framework-enabled Smartphone technology remains on the ho- 
rizon, due later this year or early next, and the first iteration 
won't even ship with the .NET runtime for Pocket PC. 

Ninety percent of winning is showing up, the adage goes, but 
Microsoft is late to the game in the arena of programmable mo- 
bile phones. The reasons aren't really important — it might be be- 
cause mobile phone companies, like set-top box companies be- 
fore them, avoided alliances with Microsoft because they feared 
being vulnerable to an embrace-and-extend strategy. The fact re- 
mains: Mobile-device manufacturers have been slow to embrace 
Microsoft-authored programming languages in mobile phones, 
whether it's .NET, Visual Basic .NET, or something else. 

On the positive side, Microsoft appears to be doing better in 
the area of PDA-style mobile devices after getting off to a slow 
stare Its Pocket PC technology continues to matiure and improve 
at a terrific clip, both in terms of its basic fiuicrionality and in the 




What do you think of the 
Microsoft Mobile Internet 
Toolkit or Microsoft's mo- 
bile strategy in general? 
Discuss this with me in the 
Talk. Editors forum on our 
Web site. Use this Loca- 
tor+ code: VS0209EN D 



way Microsoft has streamlined its 
interface for the end user. Better 
still, VB.NET developers will 
have a much more comfortable 
experience under the Compact 
Framework than when using pre- 
.NET versions of VB to program 
mobile devices. 

Microsoft's recent Pocket PC 
advances notwithstanding, corpo- 
rate environments still face a mix 
of wireless Pocket PC and Palm- 
based PDAs for the foreseeable 
foture. Unless a company stan- 
dardizes on one or the other, it 
cannot create client-side applica- 
tions for both sets of devices with 
a single code base. And no com- 
pany wants to create the same ap- 
plication twice. Some companies 
do standardize on one or the 
other, but as often as not, em- 
ployees buy the devices they pre- 
fer on an ad-hoc basis, leading to a highly heterogeneous mobile 
PDA environment. This is where MMIT shines. MMIT lets you 
target a wide range of portable devices with a single set of source. 
You can target a range of computer desktops and devices from a 
single application. A computer has different capabilities than a 
PDA, which has different capabilities than a mobile phone, 
which has different capabilities than a BlackBerry or other wire- 
less pager. All these devices have different form factors, and it 
doesn't make sense to present the same UI to all the users of 
these various devices. MMIT lets you create a single form/appli- 
cation that targets all these devices, and you can have the IDE 
warn you when a given feature exceeds the capabilities of a device 
you're targeting, letting you making adjustments as necessary. 

And this, for me, is why MMIT is what .NET is all about. It 
lets you target the users you need to target — whatever devices 
they might be using, wherever they might be using them — with- 
out having to standardize on a particulai mobile AcvVcc. Yes, you 
trade off some functionality, but the world you can tai^et ex- 
pands tremendously. It's a chance to realize the promise of the 
Web all over again. 
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Letters to Visual Studio Magazine are 
welcome. Letters must include your 
name, address, and daytime phone num- 
ber to be considered for publication. Let- 
ters might be edited for form, fit, and 
style. Please send them to Letters to the 
Editor, c/o Visual Studio Magazine, 913 
Emerson St., Palo Alto, CA 94301; fax 
them to 650-853-0230; or e-mail them to 
vsmedlt@fawcette.com. 

VB.NET: Too Far, 
of Not Far Enough? 

So Bill Storage doesn't think VB.NET goes 
far enough [Guest Opinion, "VB.NET = 
.NOT ENOUGH," VSMJuat 2002]. It's 
not a lot of fian converting real-world apps 
to VB.NET. The apps I'm converting aren't 
spaghetti-code monstrosities or VB3 throw- 
backs — they're VB6 apps that were sub- 
jected to exhaustive coding standards based 
on coherent object-oriented principles. 

Bill, what's the attraction of zero-based 
collections? I'm glad VB.NET has the same 
one-based collections I've used everywhere 
for years. Why would I want to screw every- 
one who uses my objects by making my 

Go Online! 

Use these Locator+ codes at 

www.visualstudiomagazine.com 

to go directly to these related resources. 

Download 

VS0209: All the listings and code files forthe 
September 2002 issue of VSM in one ZIP file 
VS0209NF: "Debug VS.NET Applications": 
two sample projects illustrating different 
types of bugs you might encounter in your 
application 

VS0209GS: Getting Started: the 
ContactsUtility sample application that uses 
Outlook's object model to maintain Outlook 
contacts from an Access database table; 
plus two extra code listings that show you 
how to add and update Oudook contacts 
VS0Z09DT: Desktop Developer: the business 
DLL, two apps that call it, an app that uses 
Windows controls, and a DLL with Windows 
Forms inside 

VS0209QA: Q&A: VB6 code demonstrating 
how to keep a form fully onscreen, and 
VB.IMET and C# code showing how to use 
read-only variables 

VS0209DD: Database Design: a VB.IMET 
project that uses the DDL functions 
described in this article to create a new 
SQL Server database programmatically and 
query it for schema information 
VS0209BB: Black Belt: a sample component 
that uses a synchronization domain and a 
test client, both provided in C# and VB.NET 

Read More 

VS0209LE_T: Read Letters to the Editor 
online. They include extra letters not printed 



collections zero-based when they've previ- 
ously been one-based? Zero-based collections 
are a throwback to another time. My chents 
cotint from one, and I count from one. 

I wish 'VB.NET had used a little more of 
VB6's common sense. Was it necessary to 
remove the UnloadMode parameter from 
the form's QueryUnload (now Closing) 
event? VB.NET help says you need to write 
your own logic to determine how the form 
is being closed, but what was wrong with 
forms knowing how they're being closed? 

Is it necessary to force developers to use 
circuitous calls such as System.Diagnostics.- 
FileVersionInfo.GetVersionInfo(System.Re- 
flection. Assembly. GetExecutingAssembly.- 
Location).FileBuildPart instead of VB6's 
elegant App.Revision? I realize that using 
Imports means I don't have to type all of 
it, but I still have to know all of it at some 
point to import the appropriate namespace. 
Doesn't the .NET world tolerate any of 
VB6's common-sense shortcuts? 

Bill, the "don't break my code" argument 
is economically sound. If it takes months to 
convert an app to VB.NET, then those 
months can't be spent making any money for 
the companies I work for. Your hobby apps 
might be fun to overhaul completely, but my 
enterprise-critical apps are not. 

Dave Doknjas, Surrey, British Columbia 

I agree with Bill Storage, even though change 
isn't painless. The cost of doing things cor- 
rectly is less than the cost of fixing things 
that aren't correct (or quirky). 

Joe Shapiro, Kansas City, Mo. 

I agree with Bill Storage. I think Microsoft 
did a severe injustice to the people who use 
VB who come from a C background. Cer- 
tain things should just be when it comes to 
programming. If you rely on -1 to be true 
rather than use the cookie, then you deserve 
to be hit. If you don't like short-circuit if 
statements, then you should stay with VB6. 
I, for one, think that VS.NET beta 1 , which 
followed the more standard approach to 
things, shouldn't have been compromised. 
At least give those who have a good pro- 
gramming background a way to have true 
zero-based arrays without the extra 1 , short- 
circuit ifs, true as 1 or nonzero, and so on. 

Also, I too feel that the loss of Edit and 
Continue, even if it would have been the C++ 
implementation, is devastating. This is an 
extremelyhandyandproducdvetoolandwhen 
it was taken away, I almost didn't go over. 

Troy B. Smuffir, HiJMard, Ohio 
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WOOD? 

YOU'RE fox; entertaining ones. 



information first. Fox Filmed 
Entertainment knows this. That's 
how they've become one of the 
most successful creators and 
distributors of blockbuster films 



chose Crystal Decisions™. Our 
web-based reporting, analysis 
and information delivery 
technology helps Fox track critical 
business information through 



channels and lever- 
age that information to make 
smarter decisions. With over 
10 million licenses shipped, and 
partners including SAP and 
Microsoft', we've proven our 



solutions deliver informati 
costs and improve productivity. 
Want to learn more? Visit: www. 
crystaldecisions.com /prad/002/, 
or call 1-866-821-3525. 



Access. Analyze. Report. Share" 



crystal decisions,. 



Microsoft 

CERTIFIED 

Partner 



"I had the opportunity the other day 
of 'playing' with InstallShield", and then it 
dawned on me what a great product I have in 
Wise for Windows Installer It really does 
make installing our programs simple. - 

-Martin Hart, Memory SoftS.L* 



"You-know-who" would have you believe that 
they are the only ones you should think of w/hen 
creating software installations. Our Wise for 
Windows Installer tool has convinced thousands 
of developers otherwise. Wise was the first to 
offer an installation product for Microsoft's 
Windows Installer service, first to support the 
Microsoft .NET Framework, and the first to 
create 64-bit installations. 

Take a stand for ease-of-use, reliability, and 
world-class technology and switch to Wise for 
Windows Installer 

Want to know the other reasons why you 
should switch to Wise? Get the switch kit and 
find out at www.switchtowise.com or order 
today at 800-554-8565. 

'Unsolicited testimonial from a satisfied Wise Solutions customer. 
Full text ol this quote can ho found a! www.wisesolulions.com 



Wise] 



nations made easy 



Use UMLWith .NET 



Rational XDE Professional v2002 is a serious software engineer- 
ing tool for Visual Studio .NET. XDE, which stands for 
eXtended Development Environment, allows you to analyze, de- 
sign, and document your .NET solutions fully within theVS.NET 
environment. XDE provides Unified Modeling Language (UML) 
support directly within .NET. You'll find this support particularly 
useful when you develop complex systems using C#. 

XDE supports the standard UML diagrams by addi ng the Model 
Explorer and other modeling tools to VS.NET. You use the Model 
Explorer to work with class diagrams, use cases, and other UML 
models within your .NET solutions. You create these models using 
visual components that XDE adds to the .NET toolbox. Use XDE 
to model your solutions directly within the .NET environment, and 

Rational XDE Professional v2002: .NET Edition 

Rational Software 
Web: www.rational.com 
Phone: 800-728-1212; 408-863-9900 
Price: $3,595 

Quick Facts: Adds UML and pattern templates to VS.NET. 
Pros; Solid UML support; great C# integration; strong pattern support 
Cons: Steep learning curve if you don't know UML; expensive for 
smaller projects. 
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Integrate UML Visual Editing Into the VS.NET Environment. You 

can use Rational's extended Development Environment (XDE) to 
create UML diagrams with easy-to-use visual tools. 

build these models using the same techniques you're using already 
to develop screens and other visual components. This is good .NET 
integration, but it gets better. 

The C# integration is strong. The class diagram is the heart of 
UML software design. XDE supports seamless synchronization 
between class diagrams and C#. It generates and maintains C# 
classes as you change UML class diagrams, and it does this without 



Manage ZIP Files 

Inner Media's DynaZip MAX/Active Delivery bundle is a com- 
prehensive ZIP management toolkit. It supports a wide variety of 
programming contexts, including Visual Basic, the .NET lan- 
guages, Borland's offerings, and several others. It addresses every 
imaginable ZIP management issue, including compression, direc- 
tory reciusion, multivolume creation and formatting, and the latest 
Deflate64 compression method. In addition to conventional archive 
management functionality, you can tie the library to Internet 
Information Server's (IIS's) Active Server Pages (ASP) interfece for 
dynamic ZIP handling through Web sites you develop. 

The self-extracting archive functionality is separate from the 
main ZIP management library package. The Active Delivery half of 
the bundle is available separately, as is the DynaZip MAX package, 

DynaZip MAX 5.0 and Active Delivery 3.0 Bundle 

inner Media 

Web: www.innermedia.com 
_ Phone: 800-962-2949; 603-465-3216 
} Price: $384 

; Quick Facts: A comprehensive ZIP management package for developers and 
Web content providers. 

Pros: Covers every imaginable ZIP/UNZIP scenario, including online ASP 
dynamic file handling. 

Cons: Learning curve; lack of printed documentation (two large PDF manuals 
provided, total of 568 pages to read either on your monitor or in print). 




Access a Variety of Wizards and Utilities. The DynaZIP Shell is an 

interactive front end for creating and managing ZIP files. Other 
utilities help you test and analyze archives and create scripts for self- 
extracting executables. The actual library code works through access 
to its API sets, accompanied by example code for a variety of 
programming platforms. 

but there's a hefty discount of $164 when you buy the bimdle. 
I was surprised by the depth of control and muscle I found in 

Active Delivery. I expected a typical "ZIP-to-EXE" wrapper. The 
package can do simple EXE packaging, but it can also create 
interactive installer packs^es from yom ZIP ardiives. You can 

manage tKc eng^e's API &om your ovm co<le if you needl to create 
executable distributions dynamically. The engine requires propri- 
etary script files, but it includes utilities to create and manage them, 
and there are API calls to handle the scripts through your code. The 
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UseUWlWifh.NET 

placing any markers in your code. XDE also 
supports reverse engineering by creating class 
diagrams from C# source code. With XDE, 
there's no excuse for allowing source code 
and design documents to "drift" awayfix>m 
each other diu-ing development. 

XDE also provides support for patterns. 
It allows you to use patterns to create and 
populate classes, and it comes with a set of 
industry-standard patterns created already. 
Better yet, XDE allows you to define your 
own patterns and develop your own pattern 
library. This helps you develop standardized 
solutions you use throughout your .NET 
projects. 

However, if you aren't familiar already 
with UML, then you'll need to learn it. 
XDE's documentation is good, but be pre- 
pared to make a significant investment to 
become UML-sawy. 

I found several things that could be im- 
proved within the XDE product. The help 
is decent, but it isn't dynamic help. The C# 



and class diagram synchronization brings 
over class names, attributes, and operations, 
but it doesn't do anything with class associa- 
tions. If you define an Order class that has 
1 :N Items, XDE defines neither a collection 
nor a member variable to implement the 
association. I'd also like to see the capabili- 
ties ejctended to support synchronization 
with VB.NET as well as C#. 

I found XDE to be an impressive tool, 
and I'd recommend it to anyone developing 
larger systems using .NET. 



Andy Clark is a consultant in tlie Richmond, 
Va.,area. He'sanMCSD with extensive Oracle 
and SQL Server experience. Reach him at 
theandyclark@hotmail.com. 

Manoge ZIP Files 

feature set dovetails nicely with DynaZip's 
ZIP creation/management functions. 

Using this kind of power isn't a trivial 
endeavor. There's an abundance of docu- 
mentation (all online in the form of PDF 



and help files) and a wealth of example code 
for nimierous platforms, but you still must 
confront a bit of a learning curve, especially 
if you haven't worked with ZIP archives 
before firom a developer standpoint. Al- 
though you can perform most fimctions 
with a few lines of code, it's critical that you 
understand the underlying rationale for what 
goes into those terse snippets. 

Those hurdles shouldn't dissuade you 
from examining this package, because they're 
endemic to the context rather than the prod- 
uct. The example code is well-documented 
and readable, and the online documentation 
is exhaustive. I like this package, and recom- 
mend it without hesitation. It's good value 
for the money. If you only use a fiaction of its 
power, you're still way ahead of the return on 
investment (ROI) ciuve. vsm 



Ron Schwarz lurks in rural Michigan. When 
he's not digging out of the mountain of e-mail 
in his inbox, he maintains his sanity by restor- 
ing classic cameras. He welcomes your com- 
ments at www.clubvb.com. 
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Shared Web 
Solutions 

j Develop, test and deploy your 
Web Services and applications | 
on the .NET Framework at an 
affordable price. Dozens of 
FREE components and 
valuable features are Included 
with every INNERHOST 
Shared Web Solution! 



\ Dedicated VM 
Solutions 

These solutions were 
designed from the ground up 
with one goal in mind; to be 
able to offer full dedicated 
server functionality at a much 
k)wer price. Dedicated VMs 
are enabled with all of the 
key components of .NET! 



Studies show, it's not if you'll move to 
.NET but when! Don't get left behind. 
INNERHOST has everything you need 
to make .NET work for you! 



Dedicated 
Solutions 



I- 
Robust and highly secure, 
your server Is pre-configured 
with the .NET Framework. 
An INNERMOST Dedicated 
Solution is for the devekiper 
who demands total control, 
unmatched performance 
and top notch security! 




Toll Free: 888-751-5267 

www.innerhost.com 

Complex Hosting in a Global EnwrornnanCT 



^ Visit; www.innerhost.com/winbks 
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Deploy 



Automate the mundane 



Simplify 



Write code faster 



Get a life 




Being among the first Microsoft'. NET devel 




e is not. Ttiat's wtie 



spent six years worl<ing witti Microsoft, and we've developed a new solution for .NET ttiat lets you work completely inside the 
Visual Studio* .NET shell. Want everything from modeling to code analysis right at your fingertips? Done. Want your model 
automatically updated when you write code and vice versa? Done. Want to get rid of alt/tab and static void Main ()? Done. 
Want to try out the products that can make you the best .NET developer on the planet? Go to www.ratlonal.com/offer/dotnet4. Done 




Ra-ti<:7nal 

the software development company 



Ralional and the Rational logo, among others, are trademarks or registered trademarks of Ralional Software Corporation in the United States and/or m oltier countries lUicrosof! and Visual Studio 
are trademarks or registered trademarks of Miaosoit Corporation. All other names are used for identification purposes only and are trademarks or registered trademarks of their respective companies. 
ALL RIGHTS RESERVED. ©2001 Rational Software Corporation. 



Generate Apps 
From Your Data 

Dataphor is a promising virtual database from Alphora that's 
billed as an "Automated Application Development" tool. This 
means it's a relational database environment that generates Win- 
dows and Web applications instantly from your data. 

Dataphor does this by analyzing the database tables, rules, rela- 
tionships, and constraints and converting them to a visual interface 
that includes data validation. Dataphor's master-detail forms are easy 
to use, and these extensible interfaces might be all you need. 

Dataphor can connect to multiple databases seamlessly and 
invisibly to the user. You can cross-connect to SQL Server, Oracle, 
and DB2 and incorporate them easily. Dataphor has its own query 
processor, data dictionary, and storage/retrieval system, which it 

Datapftttrl.8 K - 

Alphora 

Web: www.alphora.com 

.thone: 801-371-6080 

Prtce: $5,000 single-developer license 

Quick Facts: A database application system with added .NET components. 
Pros: Connects to SQL Server, Oracle, and DB2; generates user interfaces for 
Web and Windows automatically. 
i& M Mi^ S rtSlT'ffllli n^^ ^ n ^ Dataphor Data Application Engine. 



Connect PDAs 
to Server Objects 

Extended Systems' XTNDConnect Mobile Objects (XCMO) 
are components that help you integrate personal digital assis- 
tants (PDAs) such as Pocket PCs and Palm handhelds with back- 
end servers and enterprise data. The SDK includes client, server, and 
monitoring software. 

Exchanging data between a PDA and a database is fairly 
smooth with an all-Microsoft solution. However, companies with 
legacy databases, business objects, and Palm devices need to 
leverage their existing investments. XTNDConnect Mobile Ob- 
jects provides a workable path to making COM objects and 
ActiveX Data Objects (ADO) or ODBC data available to small 
devices. What's more, you can build these solutions with AppForge, 

XTNDConnect Mobile Objects 1.2 

Extended Systems 
Web: www.extendedsystems.com 
Phone: 800-235-7576; 208-322-7800 
Price: $395 per SDK, $595 per server 

Ottfck Facts; Client-side component.s, development tool, and server compo- 
nentsfor integrating mobile devices with back-end systems. 
Pros: Supports multiple platforms and programming languages; worlcs well. 
Cons: Example project too simplistic; license key tied to one network card. 




View Data as You Program. Dataphor includes 25 data-aware .NET 
components that show data in real time as you develop. 



calls the Dataphor Data Access Engine (DAE). It also has its own 
query and management tool (Dataphoria) and its own data query 
language (D4). However, Dataphor is a "virtual" database and 
doesn't have its own database; instead, it manages other databases 
for improved performance, management, and capabilities. 

Dataphor includes 25 .NET data-aware components that connect 
to the DAE. They range from the expected DBGrid to the snazzy 
Incremental Search. Dataphor also provides an ADO.NET data 
provider. These unique components show data as you program rather 
than at execution time. Dataphor accomplishes this by using a 
component architecture similar to what Borland has used in Delphi for 
several years. The architecture links to the DAE with a DataSession, 



XTNDConnect Mobile Objects Provide Connection Tools. You can 

connect a Pocket PC application easily to a back-end ODBC database 
by incorporating the XCMO connponents into your project. 

CodeWarrior, or Embedded Visual Studio. 

XCMO helps build the client- and server-side plumbing and 
wrappers that allow handheld computers to communicate securely 
with back ends. These COM-based solutions run over a wireless 
TCP/IP connection, a LAN, a WAN, or an Ethernet cradle. 

For this review, I incorporated XCMO into a Pocket PC 

application using a VB6 scrvcr-sidc COM ob)cct and c^A'Dedded 
Visual Basic (eVB) for the client. Setting up XCMO is fairly easy. 
One step installs the XCMO monitor service on the server. This 
directs traffic between the dient and server on port 2032 (the 



Dim CwacomerlD An Sceiua 
Din FroducclD Ju, Lon? 
Dim Quanclc? As Long 
Din ConfUmacioaNmn Is Long 




CusconerlD 
ProduccID ■ 



Result ° Pl«icetedec (Custonts^ID, Pcoducci' 
li (Err.Nunbec <> □} TUen 

HsffBox "Eri:oc " B Err . IfanAiBr G Cbr ( 13 h 
End If 



received.") Then 
HssBox Result s CtiE(13] s "Conflrimtloiti; 
Else 

HasBox Result 
End If 
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Adive Reports 2.0 is an upgrade to our best-selling reporting component. Data Dynamics offers Active Reports 

2.0 in two editions to suit your development needs. Both editions build on me power cind ease of AdiveReports 1 .0 and add 
many new features and enhancements based on your feedback. 

Active Reports 2.0 Standard Edition now supports distributable XML report layouts. Active Scripting (VBScript/ 
JScript) events and expressions and XML data sources. Active Reports 2.0 Professional Edition adds a ro : < customiz- 
able end-user report designer control. Now your users can experience the power of ActiveReports within your applications. 



CSS Slyles ■ 

ActiveX Host 

Rich Text Control 

Subreport Control 
XML Schema Tree 

ADO,DAO,RDOanclM 

Lightweight Viewer 
Table of Contents 

Splitter and Thumbnails 



Syntax-highlighting Editor 
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Data Access 



Supporis DAO, RDO, ADO. 

I<4ew! Support for XML data sources and XPdlh, XSl 

expressions. 

Supports unbound data from arrays, collections and 
other data providers. 

Binds to recordsets ond resultsets for maximum flexi- 
bility and connection efficiency. 



Architecture: 



Full runtime access Id objects, data sources and bind- 
ing, ability to add controls at njntime to modify the 
report behavior 

Full control over printer jobs, properties and output 
devices. 

Hosts ActiveX components and OLE Objects. 



Performance 



Multi-threaded scalable engine. 
Fast response time. 

" ' J Report Oiching servioe far fast web perfarm- 



Design Environment 



Easy to use Office-like designer environment. 
New! Access Reports import wizard. 

New! Crystal Reports import wizard. 

New! VBScript and JScript events and expressions 
and a buil^in syntax-highlighting script editor. 

New! ActiveReprts 1 .0 upsizer. 

Includes data bound text, checkbox, image, OLE 
objects, rich text and subreporfs. 

ActiveX controls host. Use 3rd party controls or your 
own custom controls in your reports. 

New! Barcode control. 

New! Report bookmark and internet hyperlinks. 

New! Controls Style property editor based on stan- 
dard Cascaded Stylesheets (CSS) syntax. 

PRO' Royally-free end-user report designer control. 



Deployment 



Reports con Lie compiled for maximum security and 



Newi Report layouts con be distributed as XML-based 
report layout (RPX) files (application-host independent). 

Enhanced! Java viewer based on JDK 1 .3 with print- 
ing support. 

New! TIFF export in addition to Text, RTF, Excel, PDF 
and ITTML export filters. 

Enhanced! PDF export supports table of contents 
bookmarb and embedded fonts. 



ActiveX Viewer 



Nev. ' Multipage thumbnails. 
New! Split views. 
New! Ruler 

N.'' ' Text search. 



VBxtras 



97^98 




Pricing 



Standard Edition: $499 

Professional Edition: $1299 
(inelud^ fbjdtyi'^Report Mgner) 



Readers Choice Metit 



www. datadynamics.com 
614-895-3142 Fax 899-2943 



DATA 



DYNAMICS 



Download Free Evaluation Copy 
from our websHel 



First Looks 



Generate Apps From Your Data 

creates a DataView, and finishes with a 
DataSource the components connect to. 
Unfortunately, these components connect 
only to the DAE and not to other data sources . 

Dataphor is a complex product. I had 
complete access to the Alphora support staff, 
but it still took me several days to get the 
system up and running on Windows NT 
2000. Also, the documentation isn't ad- 
equate. It lacks wizards for many essential 
tasks, including laying out a database. Its 
lack of its own built-in database or at least a 
connection to Access limits its use to all but 
the larger development shops. 

Although Dataphor is a bit wet behind 
the ears, it's essentially a good product. As I 
worked with it, I was impressed by what it 
does already, and I look forward to seeing 
what it will do with a bit more buffing and 
polishing. VSM 

John Pearson does Windows and Internet 
programming work for the Church of Jesus 



Christ of Latter-day Saints. He has contrib- 
uted to several magazines, including New 
Architect and Java Pro. You can reach John 
at compu_help@eom:puserve.com. 



Connect PDAs ... 

default). Beware that Extended Systems ties 
your license key to your network card's 
Media Access Control (MAC) address. Hard- 
ware upgrades are inconvenient because you 
rely on the vendor to generate a new key. 
Ironically, the first key supplied for this 
review wasn't valid. Still, the server contin- 
ued to operate fine in its time-limited evalu- 
ation mode. 

The installer inserts a VB6 add-in in the 
IDE called the Ghent InteJrface Expert (CIE) 
that generates wrapper code. Just point CIE 
to the server object DLL, select the target 
language (eVB, in my case), and out comes 
a VB module (BAS file) containing a class 
interface implementation forXCMO's use. 

Finally, I imported the generated code 



module into an eVB project and added a 
reference to the XCMOClientEVB type 
Ubrary. XCMO exposes fiinctionality such 
as the xcmolnit method, which initializes 
the XCMO client (the Pocket PC) with 
server connection details. Within a couple 
hours, my iPAQPocket PC, in its cradle and 
using ActiveSync, was exchanging data 
readily with the server component through 
the XCMO Monitor. 

Although the simple tutorial that walks 
you through the basic steps is welcome, 
professional developers deserve a more ad- 
vanced example — perhaps including Simple 
Object Access Protocol (SOAP). The 
XCMO SDK-style documentation is fine. 
All in all, XTNDConnect Mobile Objects 
offer a useful and workable solution for 
connecting mobile devices to your back- 
end data. 



Ken Cox is a technical writer and Web/mobile/ 

VB A developer in Toronto. Aformer broadcast 
journalist, Ken is also a Microsoft MVP for 
ASP.NET. Reach Ken at kjopc@hstmail.eom. 



BARCODE RECOGNITION TOOLKIT 

NOW YOU CAN READ AND WRITE BARCODES! 





5 7 




DOWNLOAD SMARTSCAN XPRESS AND OUR 
FULL RANGE OF DOCUMENT IMAGING 
EVALUATION KITS AT: 

www.pegasustools.com 



> PEGASUS IMAGINC 




Your applications can now read and 
process virtually any barcode, using-: 
the most powerful barcode ■ 
recognition SDK available now from 
Pegasus. SmartScan Xpress 
Barcode includes ActiveX controls 
for VB, class libraries for C + -i- and 
VCLs for Delphi. 

SnnartScan Xpress offers high-speed 
accurate readings of more than 20 
industry 1 D and 2D barcodes such 
as Code39, CODABAR, interleaved 
2 of 5, Code 128, UCC128, EAN128, 
Code93, UPC-A, PDF417 and many 
morel It also offers the ability to 
write 1 D barcodes. 

SmartScan Xpress provides 
developers with a well-documented, 
easy-to-use interface, making 
project implementation a breeze! 



(813) 875-7575 or (800) 875-7009 
sales@pegasustools.com 
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TX Text Control Does it All 




CONTROL 

The Comprehensive Text Integration Tool 



Now shipping v. 



Bullets & Numbered Lists 

Signed CAB File for Internet Download 

Print Method for Printing from IE, Access & 
FoxPro 

■ New Table Functions 

■ Extended C++ Class Library 



■ Royalty-Free Word Processor Control 

• ActiveX (Visual Basic, Delphi, VBScript,..) and 
Class Library (Visual C++) 

■ Read and Write RTF, HTML, Word 2000, 
ANii^ and Unicode 

r Run as .exe or in Internet Explorer 

(CAB file included) 

K Tables, Headers & Footers, Hyperlinks, 
Bullets, Numbered Lists, Zoom, Page View 



■ FREE Tech Support 



Virtually all applications can make use of powerful word 
processing functions. TX Text Control gives you that power and 
delivers It in a reusable component form. With TX Text Control, you 
get hands-on access to the most comprehensive set of word 
processing features available in a development todkiL 



Database 




Office 



Database Applications 

Text Control can be connected to any type of database, and store 
formatted text as binary data, RTF or HTML. You can store a 
complete document as a record, or load text from a database into 
table cells and macro fields. Typical applications which can be 
created are mail merge, report generators, formatted data entry 
masks, and all types of business apps. where documents are 
created from information stored in a database. 



Office Applications 

With Text Control you can easily create contemporary office 
applications which combine the paper and fax based office world 
with web technologies. Send faxes as email, or emails as fax, 
deploy and run the complete application over the Internet. No more 
setup programs, no more separate address books for mail,fax, and 
email. 

- Use Tables and macro fields for calculations. 
-Exchange .DOC files with MS Word 

- Insert graphics or spreadsheets as OLE objects 



Wlab Applications 

The included WebApps toolkit gives you all you need to deploy and 

run your application on the Internet: 

- Code-signed CAB file for automated download, no setup required 

- Enhanced printing and print preview functions for Internet Explorer 
-Hyperlinl<s 

- Create User Controls with Visual Basic 

- Run Text Control in a web page with HTMLA/BScript 

- Use with FrontPage, Visual Interdev, Visual Basic, or directly in 
HTML code 



The most powerful Text Control yet Is available at: 




Text Control Features 

• ActiveX for VB and Delphi 

• Class Library for Visual C++ 

. File Formats: HTML, RTF, Word 6 to 

2000, ANSI and Unicode 
. Image Formats: TIFF, BMP, JPEG. 

WMF 

• Tables 

• Headers & Footers 

• Bullets & Numbered Lists 

• Text Flow Around Emtiedded 
Images, OLE Objeets & CWtfeols 

• Undo-Redo 

• Transparent Mode 

• Read-only Mode 

• Hyperlinks 

• Macro Fields 

• Connect to Any Type of Database - 

• Unlimited File Size (>5MB) 

• Runs in Internet Explorer 

• Drag & Drop 

• Ready-to-Use Toolbars and Dialogs 
. True WYSIWYG Page View 

• Print Preview 

. Zoom 10% - 400% In Steps of 1% 

• Text Color and Background Color 
Adjustable per Character 

• Localized for English, French, 
Spanish, Italian, German and 
Japanese. Can be Translated to 
Other Languages. 

• Optional: Spell Checking with 
VideoSoft VSSpell 

• Optional: Enhanced image 
Processing with LEADTOOLS 




T^e Comprenensiw© Tejl Infegrotlon Tool 

877-898-2875 

30 day money-back guarantee 

To order: visit our website 

or Email: sales@textcontrol.com 



www.textcontrol.com 

VISIT FOR A FREE, TIIVIE-UIM LIMITED TRIAL VERSION 



VS.NET Debugging 



Debug VS.NET 
Applications 

Solve debugging issues by using the VS.NET IDE 
debugging tools effectively. 




la' VB.NET 

a SQL Server 2000 

□ ASP.NET 

□ XML 

□ VB6 



Go Online' 



Use these Locator+ codes at 
www.vi8ual8tudioni8gazine.com 

to go directly to these related 
resources. 

Download 

VS0209NF Download the code for 
this article, which includes two 
sample projects illustrating different 
types of bugs you might encounter 
in your application. 

Discuss 

VS0209NF_D Discuss this article in 
the .NET Framework/IDE forum. 

Read More 

VS0209NF_T Read this article 
online. 

N020319AN "Debug Apps Effec- 
tively With TraceContext" by 

•■ •it ■■ 



by Nancy Folsom and Kathleen Dollard 

The best way to approach debugging depends on the problem, 
language, and your experience using the language. The best ap- 
proach might change as you narrow down a problem's cause. In this 
article, we'll show you how to use the Visual Studio .NET IDE 
debugging tools to solve common problems. 



VS.NET includes a wealth of debugging 
tools — too many to discuss in detail here. Some 
highlights include the ability to set breakpoints 
and watch points; to step through code as it 
executes; to view and change variables and values; 
to navigate through the callstack of executing 
programs, methods, and events; and to include 
diagnostic debug statements. VS.NET also in- 
cludes powerful debug and trace classes, and the 
ability to do remote debugging and to attach to 
nmning processes. You can debug across lan- 
guages and drop down into an assembly-level 
view of your application, and, to top it off, you 
can control debusing programmatically. 

More than one approach might be successfiil 
in solving a problem, but most successful ap- 
proaches involve several rules of thumb (see the 
sidebar, "Debug Successfidly"). Get staned with 
your debusing efforts by downloading the Vi- 
sual C# Factory example code project from the 
VSM Web site (see the Go Online box for 
details); it contains a simple but common logic 
error (see Listing 1). The program should fill a 
shipment. When the code runs, an error dialog 
is displayed that says, "An unhandled exception 
of type 'System. IndexOutOfRangeException' 
occurred in Factory.exe. Additional informa- 
tion: Index was outside the bounds of the array." 
The error message doesn't say which array, or 
even what part of the code, is having the prob- 



lem. So, you should elect to "Break." Once 
suspended, the IDE's debugging components 
help narrow down the source of the problem. 

You can set breakpoints in the left margin 
(the red dot) of the IDE debugging Autos, Break- 

Debug Successfully 



Use these guidelines when solving debug- 
ging issues: 

• Concentrate on one issue at a time. 

• Make one change at a time as you experi- 
ment with solutions. 

•Apply the scientific method to debugging 

efforts. 

• Use source code control to log changes and to 

roll back failed experiments, 

• Comment changed code with the date and 
reason for the change instead of deleting it. 

• Use a consistent style, best practices, and 
common conventions to minimize bugs and 
to aid readability. 

• Deviate from a best practice or common 
convention on/yafteryou knowthe mie you're 
breaking and why you're breaking it. Consider 

how you could rework the implementation 
you're considering to fit the convention. 
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points, and code windows (see Figure 1). 
Notice that ToolTips show the values of 
variables. Other debugging tools are avail- 
able in tabs, such as Locals, Watch windows, 
Command window, and Breakpoints. In 
this example, the Autos window helps to 
identify the problem because the error refers 
to an array boundary, which involves vari- 
ables' values. The Autos window shows you 
the counter (i) and the array (shipment). 

Choose Between 
Locals and Autos 

You can use the Locals window instead of 
Autos. The difference between the two is 
subde. The Locals window is limited to 
showing the variables local to the currently 
executing statement. The Autos window is 
further limited to only those variables used 
on the current or adjacent lines. 

Because i is equal to the number of crates 
in the shipment, and that's what you were 
expecting (according to the code), there 
might be something wrong with your loop 
counter. Expanding the "Shipment" array 
in the Autos window shows what the prob- 
lem is: You've forgotten your array is zero- 
based. The solution is simple; you can change 
the For loop like this: 



X Factory - Microsoft Visual C# >ET [break] - Factory.CS 



Disassembly I 



Help 

- Throad [2S43] <Uo Mar 



Page 
1^* Factory 



j'!4Pscl<<lnt crates) 



Console.¥riteLine ("Packing. . . ") ; 

// Pack ch£ desired riijinbei: of crates 

for (int i = 1; 1 <= crates; 

< 

Shipment [1] ° nev Cra&ef); 



) 



teail'W»TatiftlHt'i-99| 



[STAThread] 

static void Hain(3triBcr£] args) 



Factory Sreithson = new Factory () ; 

Sitiichson.PackdOO) ; 




Figure 1 Use Debugging Windows to Diagnose Problems. When an error occurs in a 
program, elect to break it so you can see not only the line on which the error occurs, but the 
context of the error as well. What are the values of the variables? Are they what you expect? 
Does the code sometimes execute correctly? You can answer these questions quickly using 
the debugging windows. 



for tint i = 0; i < crates; 

Depending on your setting for "Changes in Visual Basic and 
Visual C# Code," found under Tools | Options | Debugging | Edit 
and Continue, it's possible to change the actual code in the For loop 
while debugging by selecting Edit | Replace to make the change. 
Once you continue the program, the IDE can either cancel the 
currently running program and restart with the code change, or 
continue running without incorporating the code change. Al- 
though this behavior is the default in C#, you must modify your 
options for this behavior in VB.NET. It's not precisely Edit and 
Continue from Visual Basic 6, but it's a useful feature. 

Notice that die BuedqiQints window in F^ure 1 shows a 
condition: 

when '1=99' 

Once you dick in the margin in the code window to set a basic 
breakpoint, you can right-click on the breakpoint and choose 
Properties. Setting a condition on a breakpoint is a common need 
and is helpful when diagnosingproblems that occur only on specific 
iterations, as in this case. If you break just before the error occurs, 
you can trace the conditions that set up the error. First, a word of 
warning: We inadvertently typed the condition as i=99, which 
changed the value of i while the program ran. So, the counter was 
always set to 99. 



When fixing a logic bug such as this one, check other related code 
for the same problem. Most of us are prone to making the same sorts 
of errors, and sometimes the most effective debugging technique is 
to understand your own vulnerabilities. The Factory example shows 
that each debu^ng tool is suited to different sorts of problems, and 
it takes some experience to figure out what each tool does and which 
sorts of problems each is best suited for. 

Use the Watch windows to enter expressions you want to 
evaluate as your program is running in debug mode. As you step 
through or debug your code, the results update to show current 
values, and you can change the value of variables in the Watch 
windows. The four Watch windows allow you to group together 
related watch expressions. 

Add a Watch Point 

You can add expressions to the Watch window in three vrays. You 
can right-click on any program variable and add it as a watch point 
or quick watch point. A watch point persists until you remove it. A 
quick watch point is a one-time evaluation. However, you can create 
a persistent watch point from the QuickWatch window. Second, 
you can select and dr^ and drop from the code window into a 
Watch window. If the Watch window is closed and v ou drag over 
the tab, it expands and allows you to drop the variable as a watch in 
the window. Finally, you ean drag and drop faoables from the 
Command, Loads, and Autos windows into a Watch window. It 
would be nice if you could drag a variable into the Breakpoints 
dialog to create a breakpoint on the variable that's changing, but this 
feature is missing from the first release. 
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Critical, Accessible, Hands-On Visual Studio® 
Technical Resources in Print and Online 



Visual Studio is the solution for enterprise-level development 
essential to your company's competitive-edge. You use Visual 
Studio components and languages to build mission-critical 
business solutions — and you need multiple resources for 
technical information to help you achieve those goals. 

Everything you need to know about using Visual Studio 
is right here: 

O Print 

Visual Studio Magazine — actionable, independent, and 
rich in content and context. 14 times a year, you get: 

• In-depth, how-to editorial about all the tools in the 
Visual Studio arsenal 

• Case studies, features, product reviews, code, and more 

Get your free trial issue now — go to www.fawcette.com/qetvsmy6C1 1 . 
Or call: 1-866-387-9275 



Visual Sti|di 

mm" ' 



mi* 





^ Online 

www.visualstudiomagazine.com builds on and expands the 
editorial from Visual Studio Magazine, and delivers unique 
content unavailable elsewhere, including: 

• Free archives — thousands of pages of code, articles, 
tips, and more from back issues 

• Discussion groups and expert advice 

O Weekly E-Newsletters 

Extra content from the magazine and Web site — hot 
topics, code, opinions and more — delivered to your 
in-box every week, absolutely free. Sign up today at 
www.visualstudiomaqazine.com 




Visual Studio Information, Any Way You 
Want It. 



These Visual Studio resources are brought to you by Fawcette Technical Publications, 
the leader in hands-on, how-to technical information for IT developnrient professionals. 
www.fawcette.com • www.visualstudiomagazine.com • www.thedotnetmag.com 
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yS^I Osbugaing 



The Osmmand window has two modes. Immediate mode is similar 
to the Watch window, and you can type in expressions. You can also 
type in any single line of code that's vaUd in the current context, allowing 
you to run methods, set and queiy the value of variables, and so on. 
Unfortunately, IntelliSense doesn't work in the Immediate mode. 

In Command mode, you can evaluate some VS.NET commands 
withlimited IntelliSense support; for example, typein ">Debug.list- 
Programs" and you see this echoed: 



>Debug . Li stPrograras 
Index Id Process 



Program 



*1 



1548 Factory.exe Factory.exe 



You can see what commands are available in the MSDN documen- 
tation under "Pre-defined Visual Studio Command Aliases" or by 
typing "alias" at the command prompt (see Additional Resources). 
You can also create your own aliases for commands you use 
commonly (see Additional Resoiu'ces). IntelliSense lists commands 
even if they aren't available in the context, and it displays a message 
to that effect if you select an luiavailable command. For example, 
choose this using IntelliSense: 



>Oebug . Appl yCodeChanges 

You see this messa^: "Command 'Debi^ApplyCodeChanges' is 
not available." 

Here's an example of the difference between Immediate and 
Command mode behavior. If you have a > prompt, you're in 
Command mode and can press Ctrl-Alt-I (or type "immed" and 
press Enter) to switch to Immediate mode, where the Command 
window displays "Immediate" in the caption. To go from Imme- 
diate mode to Command mode, type >cmd (or press Ctrl-Alt-A). 
The language you're using affects both the Command and Imme- 
diate windows. In the immediate mode in ■ 

C#, type this and press Enter to see "8": 



?3 + 5 

In Command mode, you see the > 
prompt. Type this and press Enter to see 
"8" returned: 

eval 3+5 

Evaldoesn'twork in VB.NET; instead, 
you can use the ? for Debug.Print in both 

modes. Because ? is a debugger alias and 
not a language element, it works with both 
languages' Command and Immediate 
modes. 

An example of another debugger alias is 
"Shell," which is an .ilias for Tool.Shell. 
Use this in either VB.NET or C# to nm an 
external executable from the comffland 
window. For example, typing this starts an 
instance of Notepad: 

>Shell notepad. ex© 



You can use this technique to run (and debug) another .NET 
EXE. To see an example of this, build an EXE from the Factory 
solution, then copy the Factory.exe to some directory; for simplic- 
ity, we've used the root folder of drive H:\. Now, start a new .NET 
session and open the Command window (Ctrl-Alt-A). Type this at 
the Command window: 

>Shell H:\Factory.exe 

Factory.exe has a bug in it, so the Just-In-Time Debugging 
window opens. It gives you the option to debug the Factory 
program. Once you do so, a dialog opens that lets you attach to the 

Factory process and debug the code. Tr)' this same thing while at 
a breakpoint in some other .NET project. You'll be able to debug 
two applications at once. 

Using breakpoints feels familiar, but you'll be glad to find 
additional features in the breakpoint dialog. You can make the 
breakpoint conditional on a variable value or on a hit count, and 
turn individual breakpoints on and off through a checkbox. Best 
of all, breakpoints now persist between debugging sessions, tmlike 
inVB6. 

Debug Subtle Problems 

of course, some bugs aren't solved as easily. The next example shows 
how debugging Windows. Forms events can present special chal- 
lenges. Not only does the solution depend on the IDE debiting 
components, but it also highlights how important having experi- 
ence using a langus^ can be. All the code for this example is in 
VB.NET. 

Here's the scenario: A data-entry form accepts a date and a name. 
Only the date is of interest. The date is validated to be after 1 January 
2002, using a message box to indicate failure. The form works 
perfecdy ?nost of the time. However, users report that occasionally 
entered dates "just disappear" and they don't get prompted that the 



C# • Identify the Error Using .NET's Debugging Windows 



using System; 


1 


using System. Diagnostics; 


public void PackCInt crates) ■ 


using System. Text; 


{ 




// Create a new shipment 


public class Factory 

{ 


Shipment =■ new CrateCcrates] ; 


public Crate[] Shipment; 


Consol e.Wr1teLine( "Packing. . . " ) ; 


public class FruitLoop {) 




public class Box 


// Pack the crates 


( 


for (int i=l; i<=crates; 1++) 


FruitLoop[] FruitLoops; 


1 


publ i c Box( ) 


ShipmentCi] - new CrateO; 


1 


Console. WriteCMO) M); 


FruitLoops = new 


1 


FruitLoopElOOO]; 


} 


I 


[STAThread] 


) 


static void Main(string[] args) 


public class Crate 


1 


{ 


Factory Smithson = 


Box[] Boxes; 


new FactoryO; 


publ ic CrateC ) 


Smithson.Pack(lOO): 


i 


Console. ReadLlneO; 


Boxes = new Box[144]; 

1 


) 

\ 



Listing 1 This code compiles without error, but an array bounds error occurs when it runs. 
Upon review, it seems to be packing the oorreet number of crates. You can identiiy this prob- 
lem using the .NET debugging windows. 
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date is in the wrong year (see part of the VB.NET code in Listing 2; 
download the full version from the VSMWeb site). 

The first task is reproducing the bug. This is often difficult 
because developers don't do things exactly like users, or all the bugs 
would be fixed during development. In this case, the bug isn't 
reproduced until you know the specific keystrokes that cause it. 
Once the user tells you he or she has entered "20/8/2001" instead 
of "I'm putting in the 20th of August, 200 1 ," you can conclude that 
the bug involves dates entered in European format. 



Jr% rule of thumb is to 
i^rust the youngest code 
ptAie least, so check the 
^dbbua statements first. 



Once the bug is reproducible, it's time to start gathering more 
facts about the bug — frequendy through himches. You use the 
.NET Framework Trace and Debug classes to collect information. 
Although the members are similar, the classes have distinct pur- 
poses, so the compiler treats them differently from one another. 



You use the Debug class during development. The compiler 
doesn't include the debug statements in Release builds (the type of 
build is selected in the Configuration Manager dialog found in 
VS. net's Build menu). You use Trace for code you want to leave 
in the deployed appiicatiDn. Both Trace and Debug use "listeners," 
which are an output stream, such as the console, a file, and so on. 
The default hstener for the Debug class is the debu^er's output 
window. Trace code remains in the application, and you can add or 
remove listeners as needed. 

Back to the example: 'When the bug is related to actions — 
entering a date, in this case — you place debug code in events. You 
should generally add a unique output line to all the event handlers 
that mi^t be fired. In tliis case, a Debug. WriteLine statement 
outputs the current method name, but sometimes you'll also want 
to output a key parameter's value: 

Private Sub FormatDate(ByVal sender As Object, _ 

ByVal e As ConvertEventArgs ) 

Debug . Wri teLi ne( " In Format Event") 

If Not e. Value Is DBNull. Value Then 

e. Value = Str1ng.Fornat("{0:d}". e. Value) 

End If 
End Sub 

VB.NET lets you add events by using either the Handles clause 
or the AddHandler method, so the best way to find all your event 
handlers is to search for both the Handles clause and the AddHandler 
method. 
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Option Strict On 

Imports System 

Imports System. Di agnostics 

Imports System. Data 

Imports Sysiem.Wi ndows . Forms 

Public Class Forml 

Inheri ts System. Wi ndows . Forms . Form 
Private WithEvents m_dt As New dataTableO 



#Region " Windows Form Designer generated code 



Private Sub Forml_Load( _ 

ByVal sender As System. Object, _ 
ByVal e As System. EventArgs) _ 
Handles MyBase.Load 
BuildDataO 

Dim Binding As Windows . Forms .Binding =_ 

New Windows. Forms. Binding{ "Text", _ 

m_dt, "TestDate") 
AddHandler Binding. Format. _ 

AddressOf FormatOate 
AddHandler Binding. Parse. _ 

AddressOf ParseDate 
txt Da te. Da taBindings. Add (Binding) 
txtName.DataBindings . Add( "Text" , m_dt. _ 

"TestName") 
End Sub 

Private Sub FormatDate(ByVal sender As _ 



Object, ByVal e As ConvertEventArgs) 
If Not e. Value Is DBNull. Value Then 
e. Value = String . FormatC " (0:d) ° , _ 
e . Val ue) 
End If 
End Sub 

Private Sub ParseDate(ByVal sender As _ 
Object, ByVal e As ConvertEventArgs) 
Debug. WriteLineC _ 

Convert. ToDateTime(e. Val ue ) ) 

End Sub 

Private Sub dataTabl e_Col umnChangingC 
ByVal sender As Object. _ 
ByVal e As DataCol umnChangeEventArgs) _ 
Handles m_dt.Col umnChangi ng 
.If CDate(e.ProposedValue) < #1/1/2002* Then 
MessageBox.Show( _ 

"Date must be after 1/1/2002") 
Throw New _ 

System. ArgumentOutOfRangeExcepti on ( ) 
End If 
End Sub 

Private Sub BuildDataO 

m_dt. Columns. Add (New DataColumn( _ 

"TestDate". GetType(String) ) ) 
m_dt. Columns. Add(New DataColumn( _ 

"TestName", GetType(String) ) ) 
m_dt . Rows . Add ( m_dt . NewRow ) 
End Sub 
End Class 



Listing 2 The form displays when the date entered is prior to 1/1/2002, and users complain that some dates "disappear. " Try spotting the bug. 
Evaluating the scenario explained in this article, you're likely to resolve the bug faster With a conscious, or formal, approach t) debuaging. 
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Exceptions . 



E}g:eptions: 

O C++ EKceptions 



Q Common Language Runtime Exceptions 

£ 9 JScrtit ExcepUoii 
B • System 

• System.AppOomalnUnloadsdExcBptiiin 
5ysteiT>.AppfcaBonExc6jjtoi 

'# Systein>ArguniBntExcspdc]n 
-4 System.ArguMntNiJExcQpUQn 

Systein.ArgumantOUtOfRaigeExaptlon 
*V Systein.Ariltiiii6UcExcBpUon 

• System.ArrayTypeMsmatchEsccepHon 
O System.BadlmageFonnatExceptlan 

• System.CannotUnloadAppDomalnExcspUon 
i \ h • System.ContextMarshalException 

O System. DivideByZeroException 

Q Sv*;|-Rm nllNnhFni indFvrpnhnn 
When the exc^on is thrown: - - - — 

^ Qreak Into the debugger 
^ Continue 
f» tj^ parent Mttin^ 



m 



OK 



Cancel 



ttilp I 



end... 



gear All 



add... 



IF the exception is not handM: 
^ Bc^ Ho the debugger 
f ConSnuB 
C |J9BSipr9llt,sattlng 



Figure 2 Focus Your Exception Beliavior. The Exceptions dialog 
can catch exceptions that are difficult to catch any other way. In fact, 
this technique is so powerful that it breaks on exceptions in the .NET 
Frannework. Expanding the tree and using the hierarchy designed 
into your own exceptions and Framework exceptions allows you to 
focus your exception behavior as narrowly or as broadly as you need. 

The output from the next debugging session shows that you're 
calling only the parse event: 

In Parse Event 

This is surprising, because both the Parse and the Column- 
Changing handlers have debug statements that should have ex- 



ecuted. A rule of thumb is to trust the youngest code the least, so 
check the debug statements first. If these statements look okay, 
maybe you didn't attach the ColumnChanging handler correcdy. A 
suspicion is something that can be tested, and you can phrase it as 
a hypothesis. A hypothesis is a hunch phrased in a way that allows 
you to test it. Focus on disproving instead of proving your hunch 
because test results can be consistent with multiple explanations. A 
failed test tells you that you're on the wrong track, while a successful 
test doesn't necessarily tell you that you're on the right track. 

Test Your Hypothesis 

Add a breakpoint on the AddHandler line and check that it's being 
rim. When the program hits this breakpoint, your hypothesis is 
wrong and you need to step back to the fact-finding stage and find 
a new hunch to explore. It's natural to think that disproving your 
hunch is wasted time. But you don't waste time providing and 
testing an incorrect solution, and you know precisely why you 
abandoned this direction — if you take good notes. 

Research known behavior in addition to exploring your code. 
When debugging events, it helps to understand that when an 
fexception occurs in a Windows.Forms event, remaining events are 
generally not fired. This behavior is logical because it mimics the 
behavior of multicast delegates, and some Windows.Forms sequen- 
tial events use multicast delegates. Exceptions that are raised in 
events aren't necessarily raised in your code. 

Based on this information, a reasonable hypothesis is that an 
exception is occurring in or after the Parse event, which is suppress- 
ing later events, including ColumnChanging. From a practical 
perspective, testing a hypothesis depends on the tools you have 
available. The hypothesis that events are being suppressed is testable 
because .NET has the Exceptions dialog tool that lets you request 
breaking into the debugger on all exceptions. If the application 
breaks into the debugger, there's support for the hypothesis (though 
not proof). 

Place a breakpoint at the start of the Parse event. WTien you hit 
this breakpoint, select Debug | Exceptions from the menu to display 
the Exceptions dialog (see Figure 2). Select "Common Language 



Use the Scientific iViethod 



The scientific method is useful for everyday problem solving. Use 
the method to observe a problem, />n/esf/gate when it happens and 
how it looks, hypothesize causes, experiment to test hypotheses, 
and analyze alternatives. Apply the method iteratively to complex 
problems to refine your understanding until a solution is apparent. 



have to rule out other possible explanations. 
5. Analyze the results. Was your hypothesis wrong, or is the 
solution clear? Consideraltematives: Patch, rewrite, workaround, or 
do nothing if the cure is worse than the disease. Use the project 
budget, schedule, and scope to determine the best course of action. 



1. Observe a problem to develop a problem statement. "Dates 
don't work" is vague, whereas "I can enter dates for last year, and 

that's wrong" is clear. 

2. Investigate the problem. Observe when it happens and how it 
looks, and weed out irrelevant observations by listing the steps 

necessary to reproduce the problem. 

3. Hypof^es/ze one or more explanations. Pick the most likely, or 
the easiest, to test first. 

4. Test your hypothesis with an experimenf designed to disprove 
it. If you can't disprove your hypothesis, you're not done. You might 



The methodology is compartmentalized in theory; frequently, in 
practice, it's not. Even simple debugging includes all these steps, 
although they can be transparent. Notice the steps don't include 
implementing a solution. For a sufficiently complex solution, 
approach the fix the same as you would writing any maintenance 
code. If you use source code control, you can roll back the changes 
you made while experimenting, make the correction, then test 
only the fix. While this seems like overkill, it can avoid the difficulty 
of tracking down a bug that's introduced as a side effect of making 
other changes. 
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Add Dynamic Maps to Your Applications 




By building mapping and geograpiiic 
information system (GiS) capabilities into 
your applications, you can help users to 
spot patterns and trends in their data that 
might otherwise go unnoticed. The result 
Is better, more informed decision making. 

With ESRI® MapObjects® software, you can 
quickly and easily add mapping capabilities 
to your applications. MapObjects includes 
nearly 50 embeddable mapping components 
that you can use in standard Windows 
development environments such as 
Visual Basic*, Visual Basic for Applications 
(VBA). Visual C++* Delphi™. Boriand* C++ 
Builder, Visual FoxPro*, and PowerBuilder*. 

MapObjects supports advanced geocoding, 
geometric functions, on-the-fly map projec- 
tion, GPS management, street map data, 
CAD drawing files, a wide variety of image 
formats, and much more. 

Download a free evaluation version of 
MapObjects from www.esri.com/mapobjects. 



MapObjects" 

Embeddable Mapping and GJS Components 





Copyf^hi 9 2001 ESRI. All rights reservwt- £SRI, the ESRI globe li^, and MapObjects arc rradmurics of F.SRI, rcgisienrii in the Uniicd Suics and certain other 
itgistradon is pending ui the EinapNsmCommunt^. The ^^>ObjcctI4c^ MicnMoh indihcWindi 

id-boHnaiBindemariisoi icf^sicrcd rrademadaofihdriaipocnvc trademark own 
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Runtime Exceptions" from the tree and "Break into the debugger" 
for "When the exception is thrown." If you're interested only in 
specific exceptions or exception families, expand the tree and refine 
which exceptions breaJs into the debugger. When run, the applica- 
tion breaks into the debi^er, allowing you to capture an exception 
you wouldn't see outside the Parse event. 

Even if the hypothesis appears correct, it doesn't solve the 
problem because it might open new questions. For example, if the 
exception is causing other events not to fire, why is the exception 
being raised? This question leads you to hone in on this line of code: 

Debug .Write L1ne{ Con vert. ToDateTi me _ 
Ce.Val ue) .ToStringC ) ) 

Now, you might wonder whether Convert.ToDateTime causes an 
exception on £iu°opean dates. This illustrates how important test 
conditions are in debusing, because the answer depends on the 
users' regional settings. At this point, your testable hunch and your 
hypothesis is that Convert.ToDateTime causes an exception on 
European dates if the r^onal settings are U.S. 

You could remove the line because it was a mistake to leave it in 
after your earlier debugging. However, that leaves an underlying 
problem. Notice that the application behavior is inconsistent. The 
bug occurs if the intended day is greater than 1 2, and the application 
changes the date if it's valid as a U.S.-format date. 



Additional Resources 



"^1 



I 



• Code Complete: A Practical Handbook of Software Construi 
tion by Steve McConnell [Microsoft Press, 1993, ISBN: 
1556154844] 

• "Pre-defined Visual Studio Command Aliases": http:// 
msdn. microsoft.com/librarv/def ault.asp?url=/library/ 
en-us/vsintro7/html/vxgrfpredefinedcommandlinealiases.asp 

• "Creating Custoni Aliases for Visual Studio Commands": http:// 
msdn.microsoft.com/library/default.asp?url=/llbrary/en-us/ 
^intrp7/html/vxtskcreatlngcustQmcominandlinealiases.asp 



Remote access to 
SourceSafe devel 




In this case, the solution is partly programming (remove the 
unintentional debug statement) and partly a matter of stepping back 
into design. Once you understand the problem clearly, you might 
need to sit down with the customer to figiu-e out the best solution. 
Consider all alternatives (see the sidebar, "Use the Scientific 
Method"). 

You've seen several important debugging concepts and explored 
some interesting debusing tools in the VS.NET IDE. In particu- 
lar, this article's examples show that a single bug might point to 
more than one underlying problem. Similarly, you might need to 
investigate alternative solutions because they can vary significandy 
in cost and effort. Benchmark alternatives to help identify the best 
one. Be cautious about making changes that affect the public 
interface of an application or component 
without considering how the change im- 
pacts the original design. 

Remember that building software is an 
iterative process. Developers and managers 
rely frequendy on their own j udgment when 
choosing a solution, and ofiien that's appro- 
priate. However, if a solution to a bug affects 
the user, it's a design question and will at a 
minimum require updating the project's 
documentation. A particularly difficult or 
/J iHEJJ/J ^1 nonobvious bug might require adopting a 
more formal debugging approach. Adopt 
the scientific method consciously as a way to 
prompt yourself to find any imsuspected 
assumptions or overlooked obsen^tions. i 
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groups and operation notifications to create a rkh 
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Manage Contacts 
With Outlook and VB 



Program Microsoft Outlook's object model 
from your VB6 app to manage contact lists. 



Technology Toolbox 

□ VB.NET 

□ C# 

a SQL Server 2000 

□ ASP.NET 

□ XML 

isTvBe 

QBT Other: 

Outlook 2000 or 2002 
AOO 



You can extend Microsoft Office's ftinction- 
ality by reusing portions of Office apps 
through exposed ActiveX objects. You can write 
Visual Basic for Applications (VBA) code inside 
individual Office apps, creating "macros" you 
then add to buttons and menus. And you can 
create add-ins for extending each Office app in 
a consistent manner. Best of all — at least for VB 
developers — you can access the Office suite's 
object model from external apps. 

I'll demonstrate this extensibility by showing 
you how to collect e-mail addresses on your Web 
site and build a contacts list your marketing 
department can use from Outlook. My Con- 
tactsUtility sample app shows you how to pro- 
gram Outlook by reading contact info from an 
Access database and managing entries in a con- 
tacts folder (download the app from the VSM 
Web site; see the Go Online box for details). 



Go Online! 



Use these Locator+ codes at www.visualstudiomagazjne.com to go directly to these 
related resources. 

Download 

VS0209GS Download the code for this article, which includes the ContactsUtillty sample 
application that uses Outlook's object model to maintain Outlook contacts from an 
Access database table. 

Discuss 

VS0209GS_D Discuss this article in the "Classic" VB forum. 
Read More 

VS0209GS_T Read this article online. It includes two extra code listings that show you 
^mwOoadd and update Outlook contacts. 

^Hl|k.T Getting Started, "Use SQL With ADO," by Stan Schuites 

^^Hd9^_T Getting Started, "Make Application Settings Easy," by Stan Schuites 
^^ni1SS_T "Create COM Add-ins With VBA in Office 2000" by Stan Schuites 



by Stan Schuites 

ContactsUtillty lets you add/ update contacts in 
a folder, and list or delete existing contacts (see 
Figure 1). 

You gain access to Oudook's objects by add- 
ing a reference in your VB app to Outlook's 
Object Library. You can then program against 
the exposed object model. Go to Project I Refer- 
ences, and set a reference to the Microsoft Out- 
look 9.0 Object Library for Outlook 2000 (use 
the Outlook 10.0 reference for Office XP) . The 
ContactsUtihty has the reference set already; 
open the sample app in VB6 and follow along. 

For the sample contacts, use the Suppliers 
table from the Northwind sample Access data- 
base. The Suppliers table doesn't have an Email 
field by default, so I added one and created fake 
e-mail addresses for the supplier contacts by 
combining the contact and company names (see 
the readme file for details). This database is 
included in the download as NWindEmail.mdb. 

ContactsUtillty is organized as a single form 
named frmMain. The form includes three class 
modules: CDatabase for database access, 
COutlook for the Outlook interface, and 
CSettings to read and save configuration set- 
tings in an application INI file. It's good practice 
to use classes to separate your app's functionality 
into distinct units, because it aids in developing 
and understanding the app, and rt eases later 
maintenance chores. 

The simplest of the three classes is CSettings. 
Two basic methods, GetSettingString and 
SaveSettingString, read and write settings from 
the app's INI file, which you find in tjie app's 
EXE path. Two other methods, GetAppSettings 
and SaveAppSettings, load and save the size and 
screen tacation of frmMain, so y©u can plaee thg 
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form on startup where it was the last time it ran. You might 
want to include this user-friendly feature in your applica- 
tion toolkit. On app startup, load settings and initialize the 
CDatabase class in frmMain: 

Private WithEvents moDB As COatabase 

Private Sub Form_Loacl() 
'handles form startup 
LoadSettings 

Set moOB = New COatabase 
End Sub 

The LoadSettings sub calls the CSettings.GetAppSettings 
method to read settings from the [Settings] section of 
ContactsUtility.ini: 

[Settings] 

WindowState=0 

FormLeft=1650 

ForiiiTop-1650 

FormHei ght-5145 

FormWidth=6450 

[Database] 

Connect=Provider=Microsoft.Jet.OLEDB.4.0; 
DBName= Data Source=NWindEmail .mdb 

EmailTable=Suppliers 

[Outlook] 

ContactsFolder=Personal _ 
Fol ders . Nwl ndContacts 



You also create an instance of the CDatabase class and store it in the 

form-level variable moDB. In the QueryUnload event, you do the 
reverse by saving settings and setting the moDB variable to Nothing 
to dispose of the object. 

Keep the Progress Bar Up to Date 

Use the WithEvents keyword in the declaration moDB as CDatabase. 
This tells VB you want to receive events in the form code generated 
by the CDatabase class at run time. Three events control a progress 
bar (prgContacts) on the form — one event at the start of an 
operation, another at the end, and one more as you process each 
contact item. Handle the per-contact event and update the progress 
bar within frrnMain like this: 

Private moContactltems As Long 
Private Sub moDB_UpdateOperation _ 

(ByRef Item As String. _ 

ByRef Currentltem As Long) 

If Len(Item) Then 1 stContacts .Addltem Item 

prgContacts. Value = Currentlteiti / _ 
moContactlteitis * 100 

DoEvents 
End Sub 

Add the returned Item string to fimMain's IstContacts listbox if it 
has a value, and update the progresis bar value as a percentage of its 
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Name: Chatlotte Cooper, Email: Chatlotle.Cooper@Exo(icLiquids.com 
Name: Shelley Burke, Email: Shelley.Burke@NewQrleansCaiunDeights.com 
Name: Regina Murphy, Email: Regina.Murphy@GrandmaKelljisHomestead.com 

Name: Yoshi Nagase, Email: Yoshi.Nagase@TokyoTtaders.com 
Name: Antonio del Valle Saavedra, Email: Antonio. Saavedra@CooperativadeQue; 
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List Contacts 
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Figure 1 Access Outlook Contacts Programmatlcally. The ContactsUtility 
main form demonstrates how to access Outlook contacts from within your 
VB6 application. ContactsUtiirty shows a progress bar, driven by application- 
generated events as it adds, lists, or deletes contacts. The contacts informa- 
tion comes from an Access database, with the whole application driven from 
an INI file defining configuration parameters. 



total, based on the starting valueyou store in moContactltems when 
the contact operation begins. 

The other two utility classes have a relationship in ContactsUtility. 
The CDatabase class contains all ADO code that reads and writes 
the sample database. You call three CDatabase methods from 
frmMain. These correspond to the three ContactsUtility functions: 
AddContacts, DeleteContacts, and ListContacts. These methods 
in turn call COutlook methods to access the contact data inside 
Outlook. You don't call the COutlook methods directly from 
the main form. In this sense, COutlook is contained by the 
CDatabase class. 

CDatabase handles the interface to the N WindEmail database 
through ADO. Ser a reference in ContactsUtility to the Microsoft 
ActiveX Data Objects 2.5 (or later) Library. You can find the 
ADO Connect string for the database in the app's INI file in the 
[Database] section. Keep variable settings such as database con- 
nect strings in an INI fde to give yoiu: app flexibility over time. In 
this case, you can change the database location without having to 
rebuild the app. 

COudook methods raise events as they progress through their 
tasks: StartOperation, UpdateOperation, and EndOperation. For 
example, the ListContacts method raises StartOperation at the 
beginning of the listing process, returning the total number of 
contacts found. As your program iterates through each contact, 
ListContacts raises UpdateOperation, which returns the contact 
name and current contact count. When it finishes, ListContacts 
raises the EndOperation event, which returns a status string. The 
CDatabase class method passes each of the raised events right 
through to the calling routine. 

The real Oudook programming work in ContactsUtility occurs 
within die three public COudook methods. When you create an 
instance of the COudook class, its Class Initialize event creates an 
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instance of the Outlook Application object, then calls a private Init 
routine (see Listing 1): 

Private Sub Class_Initialize() 

Set m_oOL = New Outl ook. Appl icati on 

If Not Init Then Set m_oOL = Nothing 
End Sub 

Use the Outlook Application Object 

The Outlook Application object functions as the top-level "control- 
ler" you use to program objects exposed by Outlook. The Init 
routine creates an instance of the Outlook Namespace object: 

Set m_oNS - m_oOL.GetNamespace( "MAPI" ) 

Init then reads the app's INI file, looking for a key named 
ContactsFolder in the [Outlook] section. If ContactsFolder exists, 

parse the period-delimited list and initialize the Folder object. If it 
doesn't exist, set the Folder object to the user's default Contacts 
folder and set a class-level flag; 

Set m_oFold = m_oNS.GetDefaultFolder _ 

(ol Fol derContacts ) 
mbDef aul tFol der = True 

Private Function InitO As Boolean 
Dim oSet As New CSettings 

Dim sFold As String 

Dim sFolders() As String 

'error handliini I'lui't^'! ((■'- "pace ... 
Set m_oNS = m_oOL . &etMamespace( "MAPI" ) 
sFold = oSet . GetSetti ngString( "Outl ook" , _ 

"ContactsFolder", "") 
If Len(sFold) Then 

mbDef aul tFol der = False 
sFolders = Split(sFold. ".") 
If UBound(sFolders) = 2 Then 
Set m_oFold = m_oNS . Fol ders _ 

(sFolders(O) ) .Folders (sFolders(l)) 
.Folders(sFolders(2)) 
Elself UBoundCsFolders) - 1 Then 
Set m_oFold = m_oNS . Fol ders _ 

(sFolders(O) ) . Fo1ders(sFolders(l) ) 

Else 

Set m_oFold = m_oNS. Fol ders _ 
(sFolders(O)) 
End If 
Else 

'use default contacts folder 

Set m_oFold = m_oNS.GetDefaultFolder _ 

(olFolderContacts) 
inbDefaultFolder = True 

End If 
Init = True 
End Function 



Listing 1 The private Init function sets up the Outlook objects re- 
quired for programmatic access to contact lists. The Outlook folder 
you use for contacts comes from the application's INI file as a period- 
delimited string. Parse the folder string and set a flag if you use your 
default contacts folder, because some code differs in other COutlook 
class methods. 



Once you set the Folder object, you can access contacts within that 
folder. The sample app provides three choices for contacts folders, 
starting with your de&ult contacts folder. Then there's a pubUc 
folder you can access on your Exchange server. Both of these choices 
require you to be connected to your Exchange server. You can also 
access contacts in a personal folder, which lets you test your code 
offline. You create personal folders with Outlook's File I New I 
Personal Folders File menu item. See the Outlook documentation 
for working with personal folder files. 

The AddContacts method merits a closer look (download List- 
ing 2) . The CDatabase class passes an ADO recordset as a parameter 
to this method. This introduces C0M/>/i«^between the classes, where 
one class has knowledge of how another works. Normally, you want 
to avoid this, and you do so by creating a COudook property for 
each database field, filling the properties in CDatabase and creating 
contacts within COutlook using those properties. However, in my 
simple sample app, the recordset provides a convenient shortcut 
that reduces the amount of programming required. 

AddContacts works by looping through the recordset of contact 
entries and searching the Outlook contacts list for a match by e-mail 
address. If AddContacts doesn't find a match, you add the contact. 
If the contact exists already, you update it. 

Although this example matches by e-mail address, you need to 
think about an appropriate match for your application. If the 
database entries comprise an e-mail list, every contact most likely 
has a unique e-mail address, so searching by e-mail makes sense. If 
the e-mail address in your app is optional, however, you might not 
have an entry to match by. Also, remember that unlike e-mail 
addresses, names are not unique. Many people in the world share 
exactly the same name. 

In AddContacts, start by signaling the total number of records 
to process with the StartOperation event: 

IListCount = RS.RecordCount 
RaiseEvent StartOperati on( 1 ListCount) 

Set a filter on the items in the contacts Ust to avoid any 
Distribution List items users might create manually in the Contacts 
folder: 

Dim oltems As Outl ook. Items 
Set oltems = m_oFold . I terns . Restri ct _ 
("[MessageClass] = ' I PM. Contact '" ) 

Update Recordset Contacts 

Search the Contacts folder, and add or update each contact in the 
recordset as appropriate: 

Dim oContact As Contactltem 

sFi 1 ter = " [E-mai 1 ] = " " " _ 

& RS( "Email") & 
Set oContact = oltems. FindCsFilter) 
If oContact Is Nothing Then 

sUpdate = AddContact(RS) 
Else 

sUpdate = UpdateContact _ 
(RS. oContact) 

End If 
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Start by setting a reference to a new con- 
tact in the AddContact routine (down- 
load Listing 3): 

If mbDef auHFol der Then 

Set oContact - m_oOL.CreateItem _ 
(olContactltem) 

Else 

Set oContact = m_oFolcl. Items. Add 
End If 

You use different mechanisms to add a 

contact depending on whether you're add- 
ing to the default folder (using the Createltem 
method) or to another folder (where you use 
the Add method of the Folder's Items collec- 
tion). You then set the contact's properties 
and call the Save meditid to save die new 
contact: 

With oContact 

If LenC" & RSCContactName")) 
Then .Full Name = Tr1m$("" _ 

& RSCContactName")) 
'<other contact fields omitted> 
.'Save 
ms With 

The empty string concatenated with a 
recordset field handles Null values in the 
database. Aconcatenadon between an empty 
string and a Null value produces an empty 
string. This doesn't cause errors in VB func- 
tions (such as Len) that would throw an 
error if you passed them a Null value. The 
UpdateContact routine resembles Add- 
Contact, except it checks each field for a 
change. Ifitfindsone, it updates the contact 
record using the ^me Save method. 

When you program Outlook 2000 or 
Oudook 2002 object models, seciuity dia- 
logs pop up when you access your contacts 
lists or try to send e-mail. Microsoft intro- 
duced these "features" into Oudook be- 
tween Office 2000 SPI and SP2 to protect 
you from malicious programs accessing your 
address books and sending e-mail without 
your knowledge. Unfortunately, you don't 
have a lot of options for dealing with these 
intrusive behaviors (see Additional Resources 
for Microsoft's explanations). 

The ContactsUtility sample application 
should get you started building apps that 
manipulate contacts in Oudook. Next, you 
might want to estplore how to create and 
maintain distribution lists to help manage 
your e-mail contacts. ContactsUtility ex- 
poses only the tip of the Oudook object 
model iceberg; I encourage you to esqiktre 



ftirther and see whatyou can find to entiance 
your own apps with btult-in Office fimc- 
tionality. VSM 

Stan Schultes is a Sarasota, Fla.-based Web 
and enterprise application architect and de- 
veloper, and is an MCP in VB. Stan is a 
contributing editor for VSM and writes regu- 
larly for the magazine. Visit his Web site at 
wvvw.vbnetexpert.com for online code 



demos, updates, and otherinformation. Reach 
Sim at^nfM3fie^q3@rt.MHn. 

Additional Resources 



"Developer Information About the 
Outlook E-mail Security Update" 
(Q262701): http:/support.microsoft. 
com/directory/articie.asp?id=kb; 
8n-us;q262701& 
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Use these Locator-)- codes at 
www.visualstudiomagazine.com 

to go directly to these related 
resources. 

[Download 

VS0209DT Download the code for 
this article, which includes the 
business DLL, two apps that call it, 
an app that uses Windows controls, 
and a DLL with WinForms inside. 

Discuss 

VS0209DT_D Discuss this article in 
the VB.NET forum. 

Read More 

VS0209DT_T Read this article 
online. It includes two extra 
sidebars, "Achieve Security 
Nirvana With Key Files and Smart 
Cards" and "Enable the Execution 
of Signed .NET Apps." 

VS0207ZT_T "Create a Trickle-Feed 
Application" by Zane Thomas 
''stihiii''Miiirn"a>iaii I II "1 - 



You can marry the rich user experience ofVB 
applications with the easy deployment and 
maintenance of Web apps by "Web-deploying" 
.NET WinForms apps. .NET lets you do this by 
bringing Web deployment to nearly conven- 
tional Windows apps. 

An article in a previous issue showed you 
how to create trickle-feed apps by using file 
shares for downloading (see the Read More 
section in the Go Online box for details). My 
approach differs by using HTTP and Internet 
Explorer for downloading, and by relying on 
built-in .NET mechanisms for versioning, cach- 
ing, and instantiation of classes. You can lever- 
age your current VB knowledge to develop 
flashy, high-performance, productive apps. 
Your apps can use Web services to get data from 
the server — a more efficient technology than 
bringing back whole pages. 

For example, a home banking app woidd 
deliver only your balance rather than a big page 
with yoiu balance lost somewhere in the middle. 
Such an app could even have a private directory 
to save local data if necessary. Use bandwidth 
efficiently and produce a snappy app by down- 
loading all the app's pieces (EXEs and DLLs) 
under demand and caching them pretty much 
the same way as Web pages. You can even work 
offline without the Internet connection if your 
app doesn't need server data. You can start a 
thread to download the app's components in the 
background while the user works on something 
downloaded previously. Try doing that with 
your regular Web app. 

All this bliss does have a price. You need the 
20 MB .NET Framework installed on each 
cUent, makingthis basically an intranet/extranet 
solution, at least for now. You can deploy pretty 
mueh any .NET WinForms app throi^ a link 
on a Web page, regardless of the app's size. 



by Maura Sant'Anna 

However, I recommend dividing it into one 
EXE and several DLLs so each part can be 
downloaded on demand, much like an HTML- 
based app that's downloaded page by page. For 
example, a 5 OOK app could become a 50K EXE 
and nine 50K DLLs. The latter might consist of 
"business" DLLs without user interface code, or 
DLLs that instantiate WinForms or Windows 
control DLLs with UIs of their own. 

Be sure to give all assemblies "strong names" 
by signing them digitally. A strong name in- 
cludes not only the module name (usually the 
EXE/DLL filename without the extension), but 
also a vetsion numbei, the digital sigtiatiue, and 
a culture (which can be neutral). If any of these 
things change, you have a new strong name and 
the .NET runtime regards the resulting file as 
different. It is possible to download a simple 
Windows app without using digital signatures, 
but you'll have trouble when jma use multiple 
files or try to adjust security. 

Create a Sample App 

So much fof theory — now for practice. I'll show 
you how to create digital signatures, a DLL, and 
an EXE, then deploy them over the Web. Type 
this code at the conunand prompt to create a "key 
pair" file with both a private and a public key: 

sn -k MyKey.snk 

This command creates a 596-byte file. Treat it 
with care. Anyone who obtains this file will be 
able to sign files in your stead. Put the key file in 
a smart card if you're not sure of everyone in 
yoiu own workplace (download the sidebar, 
"Achieve Security Nirvana With Key Files and 
Smart Cards" on the VSMWeh site; see the Go 
Online box for details) . 

Now create a DLL. Open Visual Studio 
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.NET and create a Visual Basic Class I<3»aiy 
project named "bizobj": 

Public Class MatOper 

Public Shared Function AddCByVaT _ 

Nl As Double. ByVal NZ _ 

As Double) As Double 

Return Nl + N2 
End Function 

Public Shared Function „ 

Multiply(ByVal Nl As Double, _ 
ByVal N2 As Double) As Double 
Return Nl * N2 

End Function 
End Class 

This simple DLL adds and multiplies two 

numbers. In practice, you'll use a more com- 
plex piece of code that might include controls 
and forms. Now give the assembly a strong 
name. Change the Assemblylnfo.vb file in the 
project with this code: 



.assenbly extern BizObj 
{ 



■ publicke^tok en - Hit ii ^^ 68 tt ki U biH 



II ♦-...Jf. 



I.'uer ^:B:^m 
asseniblt; CallBizObj 

// The follouing custoa attribute is added automatically, do not uncomRent 

// .custoR instance uoid [nscorlibJSysten. Diagnostics. DebuggableAttribute::.ctar(bool. 
// bool) • ( rt I 

.custoH instance aald [iiscorllb]S]|st».ReflBctlini.(lssMililspKej|FlleMtrlbute::.ctor(strlng) • ( D- 

7: 

.custon instance ooiil [■SGorlib]S9steii.Rantilie.lnteropSerMlces.Giiidftttribute::.ctor(string) - ( 

.custon instance uoid [iiiscorlib]Systen. Reflection. f)sseiiblyDescriptianAttribute;:.ctor(string) - 
.custom instance uoid [mscorlib]System.Ref lection. f)ssenblyTitlenttrlbute::.ctor(strlng) - ( 01 i 
.custom instance uoid [mscorlibjsystem.CLSCompliantflttribute: : .ctDr(bool) - ( 01 BO 61 QB BO ) 
.custom instance uoid [mscorlibJSystem. Reflection. ftssenblyCompanyflttribute: : .ctor(5tring) = ( 0- 
. custom instance uoid [RscorlibJSysten. Reflection. RssenblyTrademarkflttribute: : .ctor(string) = ( 
.custom instance uoid [nscorlibjsysten. Reflection. RssenblyCopyrigfttRttribute: : .ctor(string) = ( 
■custon insta nce uoid [i«5ciwIlt1Sllsteii. Reflection. RssenblyProd uctattribute: : .ctcir(string) • ( ri. 
.MUlckeu - d W 84 IfH ft l l'W H 9V II I M M W K 11 I I // .$ 

T 1 II 4..IISB1 

// .3"i(...y.I...Iil< 

// .:.''.O..I>..r 

// )...ni.bZ<S 

// ..\.« SC.tt.t" 

// .H.r-2n (. 

// ..V.a.q..»...L. 

// 3.d xj g) 

) // .«B...: 

.hasb aUBrit bm B»aeSB88B« 
l.uer iTl!l:n 
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^Assembly: AssemblyKeyFile _ 
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Figure 1 Deploy Win Apps on the Web Securely. Give your users the rich experience of 

Windows apps and the ease of deployment provided by the Web. Of course, Web deploy- 
ment raises security issues, but you can handle that by using digital signatures to employ 
private and public keys, both for your EXE and associated DLLs. Open the digital signatures 

with ILDASM.exe. Here ILDASM reveals the MANIFEST section of a DLL, showing the DLL's 
own public key and version (red) and the referenced DLL version and public key token (blue). 



Visual Studio .NET has already created an 
"AssemblyVersionC'l.O.*")" entry. You must replace that entry 
because it contains a "*" that Visual Studio interprets as asking it to 
increment the version number automatically. You don't want to get 
a new version at each compiladon because it would produce a new 
strong name, which would force you to update all references to the 
file. Instead, change the version number manually when you do 
develop a version with new functionality. Don't let it happen 
automatically at each compilation when you're in the middle dF^e 
development process. 

Copy the key file you created earlier to the project directory and 
compile it. After you generate the DLL, you can open ir with the IL 
Disassembler (ILDASM.exe) and check the manifest file for the 
version number and presence of the public key. You can create as 
many DLLs as necessary at this point. These DLLs can instantiate 
WinForms or be Windows control DLLs themselves (download the 
bonus project on the Web site). 

Now it's time to build the app. Create "Windows app" and add 
references to the DLLs created previously by selecting Project I Add 
Reference. Give the executable a strong name by changing the 
Assemblylnfo.vb file as before. Compile the app. You can open it 
with ILDASM and check its manifest (see Figure 1 ) . Check that the 
reference to the business DLL includes its name, version, and public 
key token. Visual Studio .NET sometimes fancies "0.0.0.0" as the 
version number regardless of what you tell it. If so, change the 
version number, recompile, and change back again. 

Learn Public Keys' Nicknames 

The public key token provides a 64-bit hash of the public key that 
uniquely idendfies the DLL's pubUsher. Think of the pubUc key 
token as a nickname for your public key at a more mana^J>le 



length of eight bytes. Despite being much smaller, it will be 
different for each public key generated, according to the cryptog- 
raphers at Microsoft. Use this command to obtain an assembly's 
public key token: 

sn -T BizObj.cIll 

Users can run yom app locally, but of course, your main 
objective is deploying it through HTTP. Create a directory in your 
Web server (usually at c:\inetpub\wwwroot), and call the directory 
WebDeploy. Copy both the EXE and the DLL there, and create a 
Web page as well. Call it Default.htm with a link to the executable: 

<html><body> 

<a href="CallBizObj.exe''>Call executabl e</a> 
</body></htinl> 

Users can start the app in several ways. They can open Internet 
Explorer, type the URL http://locaIhost/webdeploy, and click on 
the link to execute the program. They also can use the Start 
command at the command prompt to say "Start http://localhost/ 
webdeploy/callbizobj.exe." They can also create a shortcut on their 
desktop to http://localhost/webdeploy/callbizobj.exe. This way, 
the app behaves more like a non— Web-deployed Windows app and 
won't require users to open their browsers. 

Users need to turn off any download managers they have (such 
as GetRight or GoZilla) before clicking on the link. Depending on 
their operating system, file locations, and security options, a mes- 
sage box might open and ask what to do with the executable. The 
users need to select Open if this happens. If that doesn't work, they 
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must adjust their .NET Framework security (download the sidebar, 

"Enable the Execution of Signed .NET Apps"). 

When users run apps from their local hard disk, such apps have 
"full trust" privileges and can do anything the lo^ed-in users are 
allowed to do. Apps have fewer privileges when users run them from 
an intranet or the Internet. For example, an app run from an intranet 
cannot open an arbitrary file on the disk. If your app needs this 
privilege, change the security using the "Microsoft .NET Frame- 
work Configuration" app available in the Control Panel's Admin- 
istrative Tools section. 

Assemblies downloaded from the Web are stored in the "down- 
load" folder of the Global Assembly Cache (GAC). You can see the 
list of installed assemblies with Windows Explorer at c:\windows\ 
assembly\download. You can also use GACUTIL.exe to manage 
this directory. For example, use this command to Hst the contents 
of the download cache: 

OGACUTIL /Idl 

^ VB.NET • Resolve DLL Names and Types at Run Time ^ 

Imports System. Refl ecti on 
Function GetBizObjO As Object 

' Declare variable to hold the assembly 

Dim MyAsm As [Assembly] 

' Should use LoadFrom? 

If CheckBoxl . Checked Then 

' Load the DLL from the ful 1 URL 

MyAsm = [Assembl y ] . LoadFrom( TextBoxS . Text ) 

Else 

' Define the strong name 

Dim Name As New AssemblyName( ) 

Name. Name = "BizObj" 

Name. Version = New Versiond. 0. 0, 1) 

' Your public key tokey will be different 

Name.SetPubl icKeyToken(New ByteO I&H2B, &H3D. 

&H11. &HB8. &HEF, &H4A. &H66, &HD2)) 
Name . Cul turelnf = Nothing 
' Load the DLL 

MyAsm = [Assembly] . Load (Name) 

End If 

'Create an instance of the business object 
Return MyAsm. Createlnstance( "BizObj .MatOper" ) 

End Function 

' Sum 

Private Sub Buttonl_Cl ickCByVal sender As 

System. Object, ByVal e As System. EventArgs ) _ 

Handles Buttonl. Click 

Dim Nl As Double = TextBoxl.Text 

Dim N2 As Double = TextBoxZ .Text 

Dim R As Double = GetB1zQbj( ) .Add(Nl. NZ) 

ListBoxl. Items. Add(R) 

End Sub 

' Multiplication 

Private Sub Button2_C11ck(ByVal sender As 
System. Object, ByVal e As System. EventArgs ) 
Handles Button2. Click 
Dim Nl As Double = TextBoxl.Text 
Dim N2 As Double = TextBox2.Text 
Dim R As Double = GetBlzObj ( ) .Multi plyCNl , N2) 
ListBoxl. Items. Add(R) 

End Sub 

Listing 1 For runtime resolution, use reflection to load assemblies 
dynamically and ins^ntiate types. Use the Assembly class method 

Load whenever possible. This program creates the strong name at 
run time, instantiates a class, then calls its methods. By resolving all 
the names at run time, you can express the program's structure in an 
external file (see Fi^i-e 1 ). 



You can delete the contents of the download cache — useful during 
development — \rf typit^ diis command: 

OGACUTIL /cdl 

You implement the GAC as a series of directories under 
c:\windows\assembly. You can't examine the directories with Win- 
dows Explorer, but you can use the command prompt as a back door 
to check them. 

Reflect on DLL Names and Types 

The executable in my example contains information about all the 
DLLs it uses. The .NET Framework loader is kind enough to load 
the DLLs only when they're actually needed, such as when I use a 
type inside the DLL. This improves on Win32's behavior. Win32 
loads all the needed DLLs at once when the program is first loaded, 
even if no fiinction inside is needed. You can check this behavior by 
clearing the download cache, then deleting the DLL from the Web 
directory. You'll find that the program still executes, but it issues an 
exception when you press one of the buttons. An app can use several 
DLLs; they will be loaded on demand and stored in the GAC. You 
can even work offline (try it — select Work Offline from the File 
menu in Internet Explorer). 

Sometimes you need to resolve the DLLs' names and types at run 
time. On such occasions, use reflection to load the assemblies 
dynamically and instantiate the types. Use either of two Assembly 
class methods: Load or LoadFrom. I usually choose Load because it's 
fiister (see Listing 1) . Create a strong name based on the DLL name, 
version, culture, and public key token, then load and instantiate ic 

MyAsm = [Assembly]. Load(Name) 

MyAsm. Createlnstance( "BizObj .MatOper" ) 

Now change the HTML file De&ult.htm to link to this new 
executable: 

<p><a href=''Ca]l.B1:zObjfef.exe">ean BizStiJ asing Reflectton</a></p> 

The apps developed in this article nm inside a window separated 
from the browser. However, you can whip out a Windows control 
that runs seamlessly inside the browser window (see Additional 
Resources). You can also instantiate forms from apps started from 
the browser. And don't forget that your app can access data on the 
server through Web services. WM 



Mauro Sant'Anna is an MSDN regional director, a consultant, and a 
trainer with 20 years of development experience. He has been using 
the .NET Framework and Visual Studio actively since July 2000. Reach 
him at maurosantanna@hotmail.com. 

Additional Resources J 

• Applied Microsoft .NET Framework Programming by Jeffl^^H 
Richter [Microsoft Press, 2002, ISBN: 0735614229] 

• "INFO: How Internet Explorer Determines Positions for .NET | 
Framework Assemblies"; http-7/supporl.micrQSofl.com/ | 
default.aspx?scid=kb;en-us;Q311301 1 

• "Using Windows Forms Controls in Internet Explorer": 
www.gotdotnet.com/team/windowsformsyjesourcing.aspj$ 
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Relational 




QbjeGt-oriented 
development 



If your back-end database isn't a good match for your front- 
end development, you need a new database. Cach^, the 
high-performance database flxwn InterSystems, is a powerful 
fusion of today's mainstream technologies: objects and SQL 

Unlike Oracle and other relational databases, Cachd takes 
advantage of its efficient multidimensional data engine to 

implement an advanced object model. It doesn't try to hide a 
cumbersome relational engine beneath object-like wrappers. 



Every Cache object is compatible with Java, C-I-+, ActiveX, 
and other rapid development technologies. And thanks to 
Cache's "Unified Data Architecture,"" every object class is 
instantly accessible as tables via ODBC and JDBC. 

With no mapping or middleware. That means no wasted 
development time. And no extra processing at run time. 
So not only will your applications be quick to build or 
adapt, they will run faster too. 



Time to Change Your 

Database. 



InterSystems ^ 



Make Applications Faster 

Downloact Cach^ for free or request it on CD at www,lnter^stems.com/match17 



03002 lnter%s(ansG9(parifion.AUrig^uraMivcdlntci^fiten^ 



Keep a Window Visible 



Prevent users from moving windows offscreen, work with unsafe and unchecked 
code, and make a field variable declaration behave like a constant. 

by Karl E. Peterson, Juval Lowy, 
and Mattias Sjogren 



Sf VB.NET 

□ SQL Server 2000 

□ ASP.NET 

□ XML 

l^Note: 

Karl E. Peterson's solution 
also works with VB5. 



Go Online! 



Use these Locator+ codes at 
www.visualstudiomagazine.com 
to go directly to these resources. 

Download 

VS0209QA Download the code for 
this article, which Includes VB6 
code demonstrating how to keep a 
form fully onscreen, and VB.NET 
and C#code showing how to use 
read-only variables. 

Discuss 

VS0209QA_D Discuss this article in 
the C# forum. 

Read More 

VB0209aA_T Read Wis article 
online. 

VB0102JF_T "Drill Down on 
VB.N^ j^Jam es Fpxgjl. 
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Keep Your 
Window Visible 

How can I prevent a user from moving a window 
off the screen? I'd like to allow users to move a 
window around the desktop at will, but not 
allow them to move any part of the window off 
the desktop. The entire window must be view- 
able at all times. 

A: 

Hopefully, this is a client specification and not 
a method to keep some sort of popup advertise- 
ment perpetually in someone's face. (Online, a 
<g> would probably follow, but irritating users 
is rarely fiinny.) Assiuning a legitimate need, the 
simple answer is that you'd want to hook your 
form's message stream and respond to incoming 
WM_MOVING messages (see Additional Re- 
sources). If you don't have a favorite drop-in 
subclassing module, I'd urge you to grab 
HookMe.zip from my Web site or this coltunn's 
sample code (download the code from the VSM 
Web site; see the Go Online box for details). 

Windows sends WM_MOVING messages 
to a window immediately 
prior to the user getting any 
feedback. These messages 
are accompanied by apoint- 
er to a RECT structure in 
IParam that contains the 
drag rectangle coordinates 
Windows displays to the 
user. You're only given a 
pointer, so you need to copy 
the data at this address to a 
RECT structure declared 
within your hook procedure 
(see Listing 1). 

At this point, you're free 
to examine the RECT coor- 
dinates and even modify 
them to suit your needs. In 
this case, you'd want to en- 



siue that none of the edges go past the edge of the 
screen, and if they do, correct them to remain 

onscreen. After any necessary modifications, 
copy the updated structure back to the same 
address passed in IParam and tell Windows 

you've handled the message by returning True 
for the function result. — K.E.P. 

Q: Woric Witli Unsafe Code 

I hear you can do pointers in C#, and that you 
can manipulate memory that way. How is it 
done? Is the memory still managed by .NET? Is 
the code still managed code? 

A: 

C# does support direct memory manipulation 
using pointers. Such C# code is called unsafe 
code, because this code lets go of most of the 
safety of .NET memory management. How- 
ever, unsafe code is stiU managed code, because 
it rims in the Common Language Runtime 
(CLR), and .NET still garbage collects it. C# 
supports unsafe code to ease the task of porting 
legacy C++ applications to C# in cases that use 
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Figure 1 Configure Project Settings. The Properties page lets you 
configure project settings, including warning level, unsafe code sup- 
port, unchecked code support, and treating warnings as errors. You 
can configure different settings for Debug and Release builds. 
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Option Explicit 


Call CopyMemory(r. ByVal IParam, _ 




Len(r)) 


Private Declare Sub CopyMemory Lib "kernel32" _ 


' Adjust to prevent window from going offscreen. 


Alias "RtlMoveMemory" (Destination As Any, _ 


If r.Left < Then 


Source As Any, ByVal Length As Long) 


r. Right = r. Right - r.Left 




r.Left = 


Private Const WM_MOVING As Long = &H216 


End If 




If r.Top < Then 


Private Type RECT 


r. Bottom = r. Bottom - r.Top 


Left As Long 


r.Top = 


Top As Long 


End If 


Right As Long 


If r. Right > dX Then 


Bottom As Long 


r.Left = dX - (r. Right - r.Left) 


End Type 


r. Right = dX 




End If 


• ** + *** + *Tk-*-)t*** + *** + + *** + *** + *--jr************** 


If r. Bottom > dY Then 


' Subclassing 


r.Top = dY - (r. Bottom - r.Top) 


» ********************************************** 


r. Bottom - dY 


Friend Function Wi ndowProc( hWnd As Long, _ 


End If 


Msg As Long, wParam As Long, IParam As Long) _ 


' Update drag rectangle for Windows. 


As Long 


Call CopyMemory( ByVal IParam, r. Len(r)) 


Dim Result As Long 


' Let Windows know we've handled this. 


Dim r As RECT 


Result = True 


Dim dX As Long 




Dim dY As Long 


Case Else 




' Pas'^ alnnn tn lipffliilt injInHnw nrnrpHiirp 


' Precalculate screen dimensions. 


Result = InvokeWindowProc(hWncl, Msg. _ 


dX = Screen. Width \ Screen. TwipsPerPixelX 


wParam. IParam) 


dY = Screen. Height \ Screen. TwipsPerPixelY 


End Select 


Select Case Msg 


' Return desired result code to Windows. 


Case WM_MOVING 


WindowProc = Result 


' Grab screen coordinates of drag rectangle. 


End Function 



Listing 1 You can alter the position displayed as the user drags a window about the screen. Intercept the WM_MOVING message and alter 
the contents of the rectangle structure used by Windows to position the window's drag rectangle. 



complex pointer arithmetic. This is prob- 
ably why VB.NET doesn't support unsafe 
code. 

Unsafe code also comes in handy when 
interoperating with Win32 API calls that 
require pointers. C# unsafe code uses C- 
like pointer syntax for the most part. You 
can only use unsafe code at a method's 
scope by prefixing the method definition 
with the reserved word "unsafe," then us- 
ing C-pointer syntax for direct memory 
manipulation: 

unsafe public void 
MyUnsafeMethodKint* 
ptr) 

{ 

Debug. Assert(ptr Hnull); 
*ptr = 3: 

) 

You can only apply the unsafe qualifier to 
methods and properties, not to individual 
statements or class member variables. Note 
one important programming detail when 
dealing with unsafe code: You must pin 
down the memory sections you interact with 
diiecdy, using a fixed statement, because 



garbage collection can start at any moment 
and move objects around in memory. The 
fixed statement takes this form: 

fixed(type* ptr = expr) 

It pins down the object ptr points at, while 
the expression in the statement executes: 

unsafe void UnsafeArrayAccess( ) 

1 

int[] intArray = new int[3]; 
fixeddnt* ptr = intArray) 
( 

*ptr = 1: 
*(ptr+l) = 2; 
*(ptr+2) = 3; 

*(ptr+3) = 4; //compi 1 es , but 
unsafe and may cause error 
) 

1 

You don't need to pin down unsafe 
access to value types because value types are 
stadc allocated, so they aren't subject^ to 
garb<^e collection: 

struct Point 



( 

public int x; 
public int y: 

) 

//using unsafe struct 

unsafe void UnsafeStructUsageC ) 

I 

Point point; 
point. X = 1; 
point. y = 2; 

Point* pPoint = &point; 
pPoint->x - 3; 
pPoint->y = 4; 

I 

The C# compiler doesn't support unsafe 

code by default — you must enable it explic- 
itly in your project configuration. In the 
Project Properties page, select Build, and set 
the "Allow unsafe code blocks" dropdown 
box to True (see Figure 1). — J.L. 

Understand Checked 
and Unchecked Code 

what is checked code? How is it different 
from normal C# code? Is it the same as 
manned cod^ 



m 



By default, the C# compiler and the CLR don't check for overflow 
or underflow after performing arithmetic operations. This is called 
unchecked code. As a result, you might get erroneous results 
without knowing it, even though it's valid managed code. For 
example, consider the CalcPowerQ method that returns the result of 
a specified number raised to a specified power: 

int CalcPower (int num.int power) 



forCint i = l:i<=power;1++) 

I 

checked 
{ 

result *= num; 

I 

} 

return result; 



int result = 1; 

fordnt 1 = l;i<-power;i++) 

{ 

result *= num: 

} 

return result; 



Because int is only 32 bits long, trying to calculate CalcPower- 
(10,11) returns the bogus result of 1,215,752,192 instead of 
100,000,000,000. You can instruct the C# compiler to throw an 
exception of type OverflowException in case of an overflow error, 
using the checked instruction: 

int Cal cPower( i nt num.int power) 
{ 

1nt result = 1; 
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Now, the calling client is aware that an error took place. 
Similarly, you can fl^ a code segment as expliddy unchecked using 
the unchecked instmcdon: 

unchecked 
( 

//some code 

1 

You can nest checked or unchecked statements inside each other. 
By default, the C# compiler generates unchecked code. To enable 
support for checked code, open the Project Properties page, select 
Build, and set "Check for Arithmetic OverflowAJnderflow" to True 

(see Figure 1 ). You should use checked code for the "usual suspects" — - 
that is, calculating powers, calculating factorials, and so on. — J.L. 

Declare Constant 
Object Variables 

I wrote a class and now I want to declare a constant instance of that 
class, but the VB.NET compiler won'tlet me. Is thereaworkaround? 



The only types you're allowed to use in a VB.NET Const statement 
are the ones you can write literals for. These are the primitive types 
(numeric types, Boolean, Char, Date), String, and Object. The only 
value you can initialize an Object constant to is Nothing, because no 
allocation can occur. 

The same ndes apply to C#, except it doesn't provide a way to 
write date literals, so it doesn't support DateTime constants. On the 
other hand, it allows you to declare a null constant of any reference 
type, not only Object. 

Fortunately, VB.NET has another modifier keywordi ReadOnly, 
which you can apply to a field variable declaration to make it behave 
almost like a constant. You can initialize a read-only variable where 
it's declared or in a constructor, but you're not allowed to change it 
after that. The compiler enforces this rule, so you get a compile error 
if you try to modify a variable marked as ReadOnly in a method. 

Take a look at a couple different ReadOnly variables in use (see 
Listing 2). The code illustrates an important difference compared to 
constants. When you use a read-only variable, you can change how 
it's initialized based on calculations and parameters passed to the 
constructor. You're not limited to a single static value the way you 
are when declaring a constant. 

/Another significant distinction between the two is related to 
versioning. When you use a constant, its value is embedded in the 
code everywhere it's used. The CLR never refers to the constant field 
at nm time, and in feet doesn't even load it into meinory. This 
wouldn't work for a read-only field, because it's only semi-constant, 
and the VB.NET compiler can't determine its value at compile iame> 
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Class Ball 

Private Const PI As Double = 3.14159255 

' The following doesn't work 

• Public Const Small Ball As New BalK 5 ) 

Public Shared Readonly SmallBall As New Ball 

( 5 ) 

Public Shared Readonly BigBall As New Ball _ 

( 20 ) 

Public Readonly Radius As Integer 
Public Readonly Volume As Double 

Public Sub NewCByVal radius As Integer) 
Me . Radius = radi us 
Volume = 4 / 3 * PI * rad1us"3 

End Sub 

End Class 



Listing 2 You use constants for only simple, static values. The ReadOnly 
keyword offers more flexibility because it allows you to inrtiaiize the 
vamttem a constw^^ based on calculations and parameters. 

Because of this, you shoulci only use constants for values you' re certain 
will never change. If you change a constant, you'd have to recompile 
all code that uses it for the change to take effect. 

Also note that the VB.NET Const keyword implies Shared, 
meaning you can always access the constant without having to 
instantiate the class. ReadOnly doesn't do this, so if you want a 
read-only field to be Shared, you must add the Shared keyword 
explicitly. — M.S. 
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Additional Resources 

• HookMe.zip: vmw.mvps.org/vb/samples.htm 

• "Read-Only Variables": http://msdn.microsoft.com/librarv/ 

en-us/vbls7/html/vblrfvbspec7_5_2.asp 

• "App Object Changes in Visual Basic .NET": http:// 
msdn.miGrosoft.com/library/en-us/vbcon/html/ 
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For the past 12 years, programmers worldwide have 
recognized LEAD Technologies as the undisputed LEADer 
in imaging developer toolkits. LEADTOOLS handles all of 

your innaging needs, from common loading, displaying 
and image processing, to the complex and high 
performance imaging demands of the document, medical 
and Internet industries. Whether your project requires 
raster imaging, vector imaging or multimedia support, (or 
all of the above!) LEADTOOLS is your solution. Why 
struggle with multiple products from multiple vendors 
when you can get all of your imaging development needs 
in one toolkit? One toolkit... 




...now you're an imaging expert! 

leadtools.com 



.NET 



API 



C + + Lib. COM 



ActiveX 



VCL 



There are versions of LEADTOOLS to fit any digital imaging 
project including lastei, muUimedta, document, medical, 
Internet and vector. 



VEBSIONI^ 



sales@ieadtools.com or call: 800-637-4699 

1201 Greenwood Cliff. Suite 400 Charlotte, NC 28204 

LEAD and LEADTOOLS are ragislered trademarl^s of LEAD Technologies, inc. 
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Create Boilerplate 
Templates 



Save time and repetitive coding by customizing the code contained in new project 
files you create in VS.NET. 



□ VB.NET 

□ SQL Server 2000 
a' ASP.NET 

□ XML 

□ VB6 



Go Online! 



Use these Locator+ codes at 
www.vi8ualstudioinagazine.com 

to go directly to these related 
resources. 

Download 

VS0209AN Download the code 
listings for this article separately. 

Discuss 

VS0209AN_D Discuss this article in 
the ASP.NET forum. 

Read IVIore 

VS0209AN_T Read this article 
online. 

N020430AN "Page Templates 
Revisited" by Jonatlian Goodyear 

, P0112AN_T ASP.NET, "Create 
" ^ge Templates," by Jonathan 



Visual Studio .NET has many hooks you can 
use to customize the way it behaves. If 

you're frustrated by something — such as the 
Umited boilerplate code VS.NET's New Project 
Item "Wizard produces (see Listing 1) — ^there's 
usually a way to customize it to suit your needs. 
In this column, I'll show you how to customize 
the code VS.NET creates for files such as class 
libraries andASP.NET Web Forms by stepping 
you throi^h the process of 
creating your own project 
item template. You'll save 
yourself time, trouble, and re- 
petitive coding, and give your 
future .NET projects in- 
creased standards compliance. 

Each pf the New Project 
Item Wizards has a template 
contained undertheVS.NET 
file path. I'll assume you didn't 
modify your install path when 
you installed VS.NET, and 
that it's located at C:\Program 
Files\Microsoft Visual Studio 
.NET\. I'll call diis folder die 
root folder. The root folder 
contains a subfolder for each 
supported .NET language 
that's installed. I'll show you 
how to create a C# template 
in this article, but you can 
mirror the instructions to cre- 
ate a Visual Basic .NET tem- 
plate as well. 

The VC# subfolder under 
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the root folder contains two subdirectories you'll 
need for this project: CSharpProjectltems and 
VC#Wizards. The CSharpProjectltems sub- 
folder contains a LocalProjectltems subfolder 
and a WebProjectltems subfolder. Expand the 
WebProjectltems subfolder because you'll be 
building a Web application. Notice that this 
folder and all its subfolders match up exacdy 
with VS.NET's Add New Item Wizard. Create 
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<%@ Page 1 angudge="c#" 

Codebehi nd="WebForm3. aspx . cs" 
AutoEventWi reup="fal se" 
Inheri ts-"Testi ngStuf f . WebFormS" %> 
<!DOCTYPE HTML PUBLIC 

"'//W3C//DTD HTML 4.0 Trans i ti onal //EN" > 
<html> 
<hedd> 

<tit1e>WebForm3</title> 
<meta name="GENERATOR" Content- 

"Microsoft Visual Studio 7.0"> 
<meta name="CODE_LANGUAGE" Content="C/r> 
<meta name="vs_defaultCl ientScrlpt" 

content"" JavaScri pt"> 
<meta name="vs_targetSchema" content= 
"http: //schemas .mi crosof t .com/i ntel 1 isense/ie5"> 
</head> 

<body MS_P0SITI0NING="Gr1dLayout"> 
<form id="WebForm3" method="post" 

runat="server"> 
</form> 
</body> 
</html> 



Listing 1 The wizard tennplates that come with VS.NET are rudimen- 
tary because they need to be applicable to all development projects. 
Create your own wizard templates and add the boilerplate code that's 
specific to your company and its projects. 
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Figure 1 Add Your Own Folder. VS. NET'S Add New Item Wizard 
follows the same structure as the VS.NET folders in the file system. 
If you add your own folder to hold your custom wizard templates, it 
shows up in the wizard. The MyProject folder shown in the wizard 
holds the custom wizard templates created In this article. 

a new folder named "MyProject"; it's added to the wizard (see 
Figure 1). However, if you dick on the MyProject folder in the 

wizard, you'll see that it's empty. To add your own templates, you 
need to add a file to your MyProject folder named MyProject.vsdir. 
This is a VS .NET directory file, and you can use it to point VS.NET 
to the wizards to build your file templates. You can expedite the 
process by copying the WebProjectltems.vsdir file from the 
WebProjectltems folder and renaming it. 

Open the MyProject. vsdir file in Notepad; it contains a cryptic- 
looking listing for each type of file you can create using the Add New 
Item Wizard. Make things simple for now, and remove all the file 
types except for the ones that begin with "..\CSharpAdd- 
WebFormWiz.v^" and "..\CSharpAddClassWiz.vsz," including 
the lines that start with UI, Code, Data, Utility, and Resources. 
Your file should now have only two rows of data in it. It's never a 
good idea to overwrite any of the existing templates, so append 
"..\MyProject'' to the beginning of each of these wizard filenames, 
so that now the rows begin with "..\..\MyProjectCSharpAddWeb- 
Form"Wiz.vsz"and"..\..\MyProjectCSharpAddClassWiz.vsz."You 
need the extra "..\" because your folder is one level deeper in the 
directory structiu-e, and these are paths to acmai wfasard files (which 
rU talk about a bit later). 

Be Careful What You Change 

At this point, you might be tempted to fiddle with some of the other 
pieces of data for each row in the file. Be carefitl when you do this. 
The Globally Unique Identifier (GUID) you see on each line is the 
GUID for C# itself and must remain there. The numbers with 
pound signs (#) next to them are indexes into a private resource file 
that determines the name and description of the item that's dis- 
played in the Add New Item Wizard. 

You can change your custom project item s name by substituting 
the first index value with a textual name. For now, change the first 
ind^ values of your custom project items to MyProjectClass and 
MyProjeGtWd>FE»tii. Be sure to remove the pound sign from the 



index value as well. The second index value with the pound sign 
controls the extended description that appears in the gray box below 
the treeview in the Add New Item "Wizard. Change the index values 
to "Class library Customized for MyProject" and "Web Form 
Customized for MyProject." 

IThe fourth item in the bar (I) delimited list of data is a 
number that determines the order in which the items are 
displayed in the wizard. The item with the lowest number 
is positioned at the top, and so on. Set these ordering index 
values to 20 and 10, which makes MyWebForm appear 
first in the Add New Item Wizard. The only other piece 
of data that makes sense to customize is the last item on 
each row. Each of the files created by your template gets 
this default name unless you change it in the Add New- 
Item Wizard (numbers are appended to the end to 
prevent duplicate filenames). To demonstrate, change 
the Web Form defaidt name to Screen.aspx, and the class 
library default name to LogicClass.es. 

Earlier, you changed the names of the wizard file pointers in your 
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<%@ Page language="cr Codebehind="$FILENAME$.cs" 
AiitoEventW1reup="false" Inhen"ts="$INHERITS$" 
%> 

ODOCTYPE HTML PUBLIC 

"-//W3C//DTD HTML 4.0 Transi ti onal //EN" > 

<html> 
<head> 

<title>XYZ Company - MyProject: [loutput 

SAFE_ITEM_NAME]</title> 
<1ink rel="styl esheet" href= 

"stylesheets/xy2_intranet.css" 

type="text/css"> 
<meta name="GENERATOR" Content- 

"Microsoft Visual Studio 7.0°> 
<meta name="CCDE_LANGUAGE" Content="C#"> 
<tneta naiiie=vs_defaultGl1entScr1pt content- 

"[loutput OEFAULT_CLIENT_SCRIPT]"> 
<nieta name=vs_targetSchema content- 

" [ ! output DEFAULT_TARGET_SCHEMA] "> 
</head> 

<body MS_P0SITIONING= 

"[loutput DEFAULT_HTML_LAYOUT]"> 

<form id="[ loutput SAFE_ITEM_NAME]" 

inethod="po$t" rufiat="server"> 

<hl>Put title her€</hl> 

<hr> 
</form> 

<center> 

<b>Copy right 2002 XYZ Company - All rights 

reserved. </b> 
</center> 
</body> 
</html> 



Listing 2 This custom wizard template expands upon the existing 
Web Form wizard template that comes with VS.NET. It adds the com- 
pany name and project name to the page title, a placeholder for the 
page name, and a copyright notice at the bottom of the page. In your 
own templates, you can add as much code as you need to reduce 
your workload and add consistency to your pages. 
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using System; 

using System. Data; 

using System. Data. Sql CI lent; 

namespace [loutput SAFE_NAMESPACE_NAME] 



I 



/// <summary> 

/// XYZ Company - MyProject 

/// This code is for internal purposes only. 

/// [loutput SAFE_CLASS_NAME] 

/// </summary> 

public class [loutput SAFE_CLASS_NAME] 
I 

public [loutput SAFE_CLASS_NAME]C) 



( 



try 
{ 

// 

// TOD0: Add constructor logic here 
// 

1 

catch( Exception ex) 
{ 



f inally 
{ 



I 



Listing 3 All projects should implement exception handling, so you 
might as well create a custom wizard template that implements it. 
Company descriptions, legal notices, and detailed comment place- 
holders are some other things you might want to consider for your 
own class library templates. 



MyProject.vsdir file. Notice how each wizard file pointer begins 
with "..\..\"? Well, traverse two levels up the directory tree to the 
CSharpProjectltems folder, and you'll find a file with a VSZ file 
extension for each template in the Add New Item 
Wizard. Make a copy of the CSharpAddWeb- 
FormWiz.vsz file and rename it to MyProject- 
CSharpAddW ebForm'VClz.vsz. Do the same thing 
for the CSharpAddClassWiz.vsz file. Inside each 
of these files is the information necessary to 
launch your template wizard: 



ing the template code (which you'll create next). The WIZARD_UI 
parameter lets the wizard engine know whether the wizard has a user 
interface. In your case, it doesn't. The PROJECT_TYPE parameter 
indicates the language of the project this wizard is designed for. If this 
were a VB wizard, this parameter would be VBPROJ instead of 
CSPROJ.The only thing you must do in each ofthese files is append 
"MyProject" to die WIZARD_NAME parameter. 

Create the Boilerplate Code 

You get to create your template's boilerplate code now that you've 
finished all the plumbing. Earlier I mentioned the VCfWizards 
folder directly under the root folder. If you click on this folder, 
you'll notice it has a subfolder corresponding to each wizard file 
(with the VSZ file extension) in the WebProjectltems folder. The 
VS.NET wizard engine knows which folder to look in by examin- 
ing the W1ZARD_N AM E parameter in the wizard files you just 
created. Find and make a copy of the wizard folders for 
CSharpAddWebFormWiz and CSharpAddClassWiz, appending 
"MyProject" to each one. 

Each of your wizard folders has two subfolders. Scripts and 
Templates. The Scripts folder contains the default.js file (undo' 
another subfolder named "1033"). Don't modify this file, became 
it uses symbols that are private to VS.NET. These symbols can 
change at any time, so you risk breaking your template if you change 
anything in that file. Forget it exists. The Templates folder (actually, 
the "1033" subfolder underneath it) contains the files you can 
modify. The MyProjectCSharpAddWebFormWiz wizard presents 
you with two files. The Templates.inf file merely points to the files 
needed for the wizard (only one in the case of both your new 
wizards). You don't need to rename the file listed in Templates.inf, 
because VS.NET extracts the proper name for your new files finm 
the MyProject.vsdir file you built earlier. 

Open the WebForml.aspx file and add any custom code you 
want. You'll notice a few symbols such as $FILENAME$, SAFE_ 
ITEM_NAME, DEFAULT_CLIENT_SCRIPT, and DEFAULT_ 
HTML_LAYOUT. You can change or remove these, but I wouldn't 
recommend it. VS.NET uses them to wire up the templates to the 
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VSWIZARD 7.0 

Wi zard=VsWi zard.VsWizardEngine 
Param-"WIZARD_NAME =" 

"MyProjectCSharpAddWebFormWiz" 

Param-"WIZARD_UI = FALSE" 
Param-"PROJECT_TYPE - CSPROJ" 

The first Une indicates that this wizard is meant to 
run using VS7 (numbered for compatibility with 

fudire versions of VS.NET). The Wizard item Figure 2 Add Boilerplate Ul Code. Instead of being greeted with an empty screen 

indicates thewizard engine to use. In the three tows when you create a new Web Form, you can create your own custom wizard templates 

that b^;inwidi"Param=", the WIZARD_NAME to inject boilerplate user interface code that needs to exist on every page. You can also 

parameter is thename<^ilLe wizardMdet contain- add placeholders for Items you don't want to forget white devselopini your Web Row®. 



Put title here 
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file/ class names that you specify in the Add New Item Wizard, as 
well as your VS.NET IDE preferences. 

As an orample, I customized the <title> HTML tag with the 
name of a fictional business (XYZ Company) and the project name 
(MyProject). I also added a default page title and <hr> tag, as well 
as a copyright message at the bottom (see Listing 2). In a real-life 
project, you'd want to add any code that every page needs to 
implement but might be forgotten otherwise. Open up the 
NewCSharpFile.es file in the "\TempIates\1033" subfolder of the 
MyProjectCSharpAddClassWiz wizard folder. You might want to 
replace the SAFE_NAMESPACE_NAME symbol with the 
namespace you want each of your classes to use, but you should 
leave the SAFE_CLASS_NAME symbol alone, because it corre- 
sponds to the filename you specify in the Add New Item Wizard. 
Some appropriate things to add to class templates are commonly 
used namespace references, default comments (including company 
and project name), licensing ^sclaimersj aad de&ult exception- 
handling logic (see Listing 3). 

Now that you've finished your wizard template, try it out in 
VS.NET. If you have VS.NET open already, shut it down and 
restart it. The IDE caches your previous wizard settings, so you want 
to force them to be reloaded with your new wizard options. Open 
a C# ASP.NET project, and open the Add New Item Wizard. Your 
MyProject folder should be there. CUck on it and select the Web 
Form option. Notice that it indicates ScreenLaspx as the default 



filename. Click on the Open button. You should be presented with 
a Web Form that reflects the boilerplate code you added to your 
vsfizard template (see Figure 2). 

The steps you've taken to create your wizard template might 
seem like a lot of trouble to go through, but remember all the time 
having a boilerplate template will save you. I hope I've also encour- 
aged you to explore VS.NET to find some of the neat (and often 
undocumented) things you can do vnth it. Remember to always 
make backup copies of any configuration files before you modify 
them, in case something goes wrong and you need to revert back to 
the way things were before. 
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Manipulate Schema 
Information 

Explore your options for manipulating a table's schema programmatically. 




Technology Toolbox 
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Download 

VS0209DD Download the code for 
this article, which includes a 
VB.NET project that uses DDL 
functions to create a new SQL 
Server database programmatically 
and query It for schema Information. 

Discuss 

VS0209DD_D Discuss this article in 
the ADQ.NET forum. 

Read More 
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"Understand ADD Headaches in 
.NET Applications." 

VB9906JM_T "Ease Data Access 
With ADOX" by Jeffrey P. IVIcManus 

VS0111GS_T Getting Started, 
"Share Data Between Database 
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ADO.NET doesn't provide classes for 
schema manipulation, although Microsoft 
plans to build an all-encompassing .NET object 
model for the data source's Data Definition 
Language (DDL). In this column, I'll examine 
the three options you have today to manipulate 
a table's schema programmatically — to create 
tables, views, indexes, constraints, and more. 
The ADO.NET options for accessii^ andttiodi- 
fying a data source's schema are the data source's 
SQL interface, the default programming inter- 
face of the data source's OLE DB provider, and 
the COM ADOX object model's functions — 
namely, the Microsoft ActiveX Data Objects 
Extensions for Data Definition Language and 
Security (ADOX). 

Some differences between ADO and 
ADO.NET become apparent when you con- 
sider that in the .NET Framework, a new breed 
of components, called data providers, serve as a 
bridge between applications and data sources. 
Data providers and client applications exchange 
data by using the classes defined in the System. - 
Data namespace — the actual ADO.NET class 
library. Although the library's name suggests 
some sort of close relationship with the COM- 
based ADO library, ADO and ADO.NET 
have different design centers and feature a 
different set of objects. In addition, although 
their overall functionalities intersect, not all 
the ADO functions are available inADO.NET, 
and vice versa. (Download the sidebar, "Un- 
derstand ADO Headaches in .NET Applica- 
tions," from the V3!MWeb site; see the Go 
Online box for details.) 

Any commercial DBMS provides you with a 
set of SQL commands or other programmable 
tools, which you can use to execute DDL state- 
ments. A DDL statement lets you perform 
schema manipulation on a database or a catalog. 
Typical DDL statements arc CREATE TABLE 
and ALTER COLUMN, which respectively 
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create a new table and modify paiameters on a 

column. 

From a .NET data provider's perspective, a 
DDL statement is the same as a SQL command. 
Like INSERT or UPDATE statements, a DDL 
statement doesn't return rows, so you only need to 
use the Command object's ExecuteNonQuery 
method to process it. You can create a new database 
element in SQL Server's local instalhlira: 

Dim s As String 

s - "SERVER-localhost;UID=sa;" 
Dim conn As Sql Connection 
conn = New SqlCohnection(s) 

Dim c As String 

e =■ "CREATE DATABASE MyDatB' 

Dim cmd As Sql Command 
cmd = New SqlCommand() 
cmd, Comma ndlext = c 

cmd. Connection - conn 
conn.Open( ) 
cmd . ExecuteNonQuery ( ) 
conn . CI ose( ) 

In particular, employ this DDL command: 

CREATE DATABASE Mypaita 

This command creates a new database with all 
the default settings for the size of the database's 
primary file and transaction log. Also, you don't 
specify a MAXSIZE, so the files can grow to fill 
all available disk space. You can create new 
databases with special characteristics program- 
matically by using a more articulated version of 
the CREATE DATABASE command. Simi- 
larly, you can create tables with the specified 
number of columns, primary keys, and con- 
straints (see the T-SQL documentation iti Books 
Online fot how to accomplish this iMk with 
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Figure 1 Integrate Information With the Rest of Your App. The 

sample application creates a new SQL Server database with one child 
table, then reads back the information about the newly created table. 
It also allows you to view the table schema using both SQL Server 
statements and the OLE DB functions. 

SQL Server). This article's sample code uses this command to create 

a MyClients table with two columns (download the code from the 
VSM Web site). One column acts as the primary key and is 
autoincremented: 

USE MyOata 

CREATE TABLE MyCl ients( 

ClientID smallint IDENTITYd, 1) 

PRIMARY KEY, 
Name varchar(80) NOT NULL) 

The database DDL implementation also comes in handy if you 
need to read schema information from an existing database. For 
example, suppose you want to read back the structure of tile just- 
created MyData database. Any SQL Server database maintains 
schema information in system tables accessible by INFOR- 
MATION_SCHEMAviews.ThcINFORMATION_SCHEMA.- 
COLUMNS view contains schema information about each table 
defined within the catalog. Available columns include column 
name, data type, maximum character number, whether the column 
is nullable, and more (see Listing 1 for how to set up this DDL 
command for execution): 

USE MyData 

SELECT COLUMN_NAME. 

ORDINAL^POSITION, 

COLUMN_DEFAULT. 

IS_NULLABLE. 

DATA_TYPE 
FROM 

INFORMATION_SCHEMA. COLUMNS 
WHERE TABLE_NAME = 'MyClients' 

ADO.NET returns the information to you as a DataSet object so 
you can integrate it easily with the rest of the application (see the 
results in Figure 1). 

Use OLE DB Features 

You can resort to the OLE DB programming interface to access 
schema informiation if you don't plan to use the DBMS . NET native 
data provider, or if a .NET provider isn't available yet for your 
database (if you're using Sybase, Informix, or DB2). 

The OLE DB .NET data provider makes schema information 
avaikbk through a metlicKl oti the OleDbCdnnection object called 
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Function GetSql SchemalnfoC ) As DataSet 
Dim s As String 
s = ConnectionString 
Dim conn As SqTConnecti on 
conn = New SqlConnection(sO 

Dim c As String 

c = "SELECT • 

c += "COLUMN_NAME, " 

C += "ORDINAL_POSITION, " 

C += "COLUMN_DEFAULT, " 

c +=■ ''IS_NULLABLE, " 

c += "DATA_TYPE FROM " 

c -f= "MyData. INFORMATION_SCHEMA. COLUMNS 

c += "WHERE TABLE_NAME = 'MyClients'" 

Dim cmd As SqTCommand 
cmd = New Sql Commando 
cmd. Connection = conn 
cmd.CommandText = c 

Dim da As Sql DataAdapter 
da = New Sql DataAdapter( ) 
da.SelectCommand = crad 

Dim ds As DataSet 
ds = New DataSet () 
da.FilKds, "Schema") 
Return ds 

End Function 



Listing 1 A built-in table called INFORMATION_SCHEMA contains 
information about the schema of all the tables that belong to the 
database the application is connected to. 

GetOleDbSchemaTable: 

Public Function GetOl eDbSchemaTabl e( 
ByVal schema As Guid, _ 
ByVal restnctO As Object) As DataTable 

The method takes two arguments and returns a DataTable object 
populated with all the requested schema information. The first 
argument serves to identify which category of schema information 
you're asking for. The schema category is an element of type 
OleDbSchemaGuid. The OleDbSchemaGuid class contains only 
static members, each of which maps to a predefined OLE DB schema 
rowset including catalogs, tables, columns, constraints by table, and 
more. For example, by setting the schema argument to 
OleDbSchemaGuid.Catalogs, you instruct the OLE DB provider to 
renim a list of all the catalogs in the specified instance of the DBMS: 

dt = conn . GetOl eDbSchemaTabl e{ 

01 eDbSchemaGui d .Catal ogs , Nothi ng ) 

The connection string plays a key role because the GetOle- 
DbSchemaTable works on top of an open connection. First, make 
sure the connection string includes the PROVIDER token so you 
can locate the desired OLE DB provider. Use this call to get all the 
SQL Server's catalogs on the local machine: 

s = "SERVER"...; UID=...;" 
s += "PROVIDER-sqloledb:" 
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conn = New 01 eDbConnecti on( s ) 
conn.Open( ) 

Next, if you want to query a particular catalog, you can set its 
name in the connection string through the DATABASE token. 
However, the connection string doesn't allow you to restrict the 
amount of information returned in a flexible way. 

Using the second argument of the GetOleDbSchemaTable 
method results in much more powerfiil code. The restrict aigamcnt 
is an array of Object types whose size depends on the schema GUID 
you selected with the first argument. The argument acts as a kind of 
WHERE dause for ail the elements in the specified schema type's 
restriction table. A restriction table comprises the parameters you 
can filter the schema information on. Catalogs, Tables, Columns, 
and all the possible other members of the OleDbSchemaGuid class 
have their restriction tables. Use this code to get column informa- 
tion for the MyData.MyClients table: 

dt = conn.GetOTeDbSchemaTable( _ 
01 eObSchemaGufd . Catal ogs , f i 1 ters ) 

The filters argument is an array of Object types with four 
elements, because the Columns restriction table contains four 
elements: catalog, schema, table, and colmim name: 

Dim filtersO) As Object 
f1lters(0) = "MyData" 
filters(l) = Nothing 
filters(2) ■= "MyClients" 
filtersO) - Nothing 

This code sets the command to query for schema information about 

all the columns in the MyClients table in the MyData catalog. You 
could restrict the resultset to only the specified column by setting the 
fourth element to a column name. Pay attention to the array's size; 
it must always be no greater than the size of the element's restriction 
table. (See the .NET Framework documentation to learn about the 
characteristics of each restriction table. ) The GetOleDbSchemaTable 
method retiurns a DataTable whose number of columns cannot be 
filtered but includes as much information as you need. 

Not all OLE DB providers might support all the schema types 
the method can take in. In this case, you're returned an empty 
DataTable. 

Understand ADOX 

Both SQL and OLE DB share a common approach to getting 
schema information. Both execute low-level commands and, to 
some extent, force you to reason in a low-level way. You can obtain 
any piece of schema information only through the underlying 
database, but this doesn't mean you must work in this way. OLE DB 
provides a first level of abstraction and allows you to call only one 
method, irrespective of the physical data source's intricacies. The 
rub with OLE DB lies in the fact that it treats schema information 
as read-only, and you can't alter the database's state. Although better 
than nothing, this isn't exacdy what people would hope for. You 
m^t think you could resort to ADOX if you want to use an object 
model to issue DDL statements. 



ADOX is an extension to the ADO objects that includes objects 
for schema creation and modification, as well as security. ADOX lets 
you write object-based code that works against various data sources, 
regardless of differences in their native syntaxes. With ADOX, 
creating tables and colimins is as easy as creating new instances of 
existing objects. Among other things, ADOX makes fiilfilling any 
business logic seamless while initializing or modifying the data 
layer's structure. 

Unfortunately, ADOX has several limitations when called to 
work with ODBC and OLE DB providers other than the Jet OLE 
DB Provider. This is because ADOX itself is designed primarily for 
use with Access databases. However, although ADOX has some 
limitations (that is. Jet's notion of a catalog doesn't match SQL 
Server's) , you can also read and write schema information on a SQL 
Server table. 

Using ADOX firom within a .NET application is harder thati 
using ADO. You import the ADOX librar)' into the project and 
startusingthe objects you need. One caveat: You can't useADO.NET 
connection objects. An ADOX catalog recognizes only ADO's 
coimection objects. If you try to bind the ADOX Ubrary to an 
OleDbCoimection object, an ^ception is thrown because ADOX 
queries for a missing inter&ce. You must import ADO in order to 
use ADOX. 

ADO.NET has no special support yet for schema manipulation. 

As of today, you must endeavor to find the best workaround that 
fixes your particular problem. The most powerful is the first I've 
shown here — that is, using the provider-specific DDL instructions. 
If you don't need to do complex tasks, consider ADOX, but also 
consider that ADOX affects performance due to its COM nature. 
However, this might not be a big issue for a one-shot call. OLE DB 
provides a .NET-specific, higher-level approach, but doesn't allow 
you to make schema changes to the database. 

According to announcements made and tech-preview demos 
shown at Microsoft:'s Professional Developers Conference (PDC) 
200 1 , Microsoft is committed to improving the ADO . NET model 
in the next major release of the .NET Framework. Although details 
are subject to change, Microsoft plans to address the lack of powerfU 
and native tools for schema manipulation with a new ADOX-Uke 
object model. This would allow you to create catalogs and tables 
using an object-based approach with no limitations. The idea is to 
add a new group of classes to the specification of .NET data 
providers so each one can provide object-oriented replacements for 
today's DDL statements. VIM 



Dino Esposito is a trainer and consultant for Wintellect (www. 
wintellect.com). He writes for MSDN Magazine and MSDN Voices. 
The author of Building Web Solutions with ASP.NET and ADO.NET 
(Microsoft Press) and of the upcoming AppliedXML Programming for 
Microsoft . NET, Dino is also the cof ounder of www.vb2themax.eom. 
Reach him at dinoe@wintellect.com. 



Additional Resources 

Microsoft ADO Extensions 2.1 for DDL and Security ; 
Object Model: http://msdn.microsoft.com/library/ 
default.asp?url=/llbrary/en-us/modcore/html/ 
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to go directly to these related 
resources. 

Download 

VS0209BB Download the code for 
this article, which includes a 
sample component that uses a 
synchronization domain and a test 
client, both provided in C# and 
VB.NET. 

Discuss 

VS0209BB_D Discuss this article in 
the .NET forum. 

Read More 

VS0209BB_T Read this article 
online. It includes inline code in 
both C# and VB.NET. 

VS0202BB_T Black Belt, "Demystify 
.NET App Domains and Contexts," 
by Juval Lowy 
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The introduction of multithreading into your 
VB6 apphcation opens up a Pandora's box 
of synchronization and concurrency manage- 
ment issues. You have to worry about threads 
deadlocking while contesting for the same re- 
sources. You must synchronize access to objects 
by concurrent multiple threads. And you have to 
handle method re-entiance. 

Your first step in tackling such issues is to 
build thread-safe components by equipping them 
with mechanisms that prevent multiple threads 
from accessing them and corrupting the state of 
the objects. This helps, but it still doesn't pre- 
vent deadlocks, which occur when thread Tl, 
which owns thread-safe resource Rl, tries to 
access thread-safe rcsoiu"ce R2 just as R2's owner, 
thread T2, tries to access Rl (see Figure 1). 
Multithreading defects are notoriously hard to 
isolate, reproduce, and eUminate. They often 
involve rare race conditions, and fixing one 
problem often introduces another. Before 
.NET, it was nontrivial to write robust, high- 
performance, multithreaded code. You needed 
a great deal of skill and discipline to succeed. 

Enter .NET, which aims at simplifying com- 
ponent concurrency management. By default, 
all .NET components execute inamultithreaded 
environment that allovsrs concurrent access by 
multiple threads. I'll showyou how to use .NET's 
automatic synchronization, which lets you deco- 
rate your component with an attribute and have 
.NET manage concurrent access to the object. 

Automatic synchronization revolves around 
intercepting calls coming into a component's 
context (see the Read More section in the 
Go Online box for more information on app 
domains and contexts). Components must be 
context-bound to take advantage of.NET auto- 
matic synchronization. This means you need to 
constrain them to execute always in the same 
context. These components must derive from 
the ContextBoundObject class direcdy or indi- 
rectly, and they must use the Synchronization 
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attribute, defined in the System.Runtime.Re' 
moting. Contexts namespace: 

//C# 

using System. Runtime. Remoting. Con texts ; 
[Synchroni zati on] 

public class MyClass : ContextBoundObject 
{ 

public MyClass(){] 

public void DoSomething( ) 1 1 

//other methods and data members 

) 

The Synchronization attribute, combined with 
the ContextBoundObject base class, tells .NET 
to place the object in a context and associate it 
with a lock. When a client on thread Tl tries to 
access the object by calling a method on it (or 
accessing a public member variable), the dient 
actually interacts with a proxy. .NET intercepts 
the client access and tries to acquire the lock 
associated with the object. If the lock isn't owned 
by another thread currendy, .NET acquires the 
lock and accedes the object on thread Tl . .NET 



V 



I R1 i 

Owns 

Access attempt 



R2 



Figure 1 Multithreading Can Be Deadly. A 

deadlock can occur when two or nfiore threads 
each owns a resource and Is waiting for a re- 
source owned by another thread. Deadlocks are 
notoriously hard to resolve and often appear un- 
predictably. 
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Figure 2 Synchronize Domains, Contexts, and App Domains. The .NET 

Framework's synchronization domains can save you from error-prone manual 
tinread synclironization. A synclironization domain is independent of context, but 
is limited to a single app domain. A context belongs to one synchronization do- 
main at most. 



releases the lock and returns control to the client when the call returns 
from the method. However, if another thread T2 were accessing the 
object, then Tl would be blocked until T2 releases the lock. In fact, 
all other threads are placed in a queue while the object is accessed by 
one thread, so they get to access the object in order one at a rime. 

Avoid Deadlocks With Shared Locks 

.NET could have allocated one lock per context-bound object, but 
that vyould have been inefficient. Objects can often share a lock and 
execute on the same thread — if by design the components are all 
meant to participate in the same activity on behal fofaclient.Insuch 
situations, allocating one lock per object would waste resources and 
processing time, forcing .NET to do additional locks and unlocks 
on every object access. Moreover, sharing locks among objects 
would reduce the likelihood of deadlocks. If two objects interact 
with each other and each has its own lock, two different cUents on 
different threads can use these objects. The objects woidd then 
deadlock when they try to access each other. If the objects were to 
share a lock, only one client thread would be allowed to access them. 

In .NET, a set of context-bound objects sharing a lock belongs to 
^synchronization domain. Each domain has one lock; multiple threads 
can't make concurrent calls vidthin the same synchronization domain . 
When a thread accesses one object in a synchronization domain, that 
thread can access the other objects in the domain. In fact, the 



synchronization domain locks all its objects from access by 
other threads, even though the current thread in the 
domain accesses only one object at a time. 

Synchronization domains are context-independent 
and can include objects from midtiple contexts. How- 
ever, a synchronization domain is limited to a single app 
domain: Objects from different app domains can't share 
a synchronization domain lock. A context can belong to 
no more than one synchronization domain at a time, if 
any. If a context belongs to a synchronization domain, 
then all the objects in that context belong to that 
synchronization domain (see Figure 2). 

You need to decide how to associate a component 
with a synchronization domain lock. You can choose 
whether the object needs a lock at all, whether it can 
share a lock with other objects, or whether it reqiures a 
new lock. The SynchronizationAttribute class provides 
a number of overloaded constructors, all accepting a 
constant integer flag. Possible values for the flag are NOT_SUP- 
PORTED, SUPPORTED, REQUIRED, and REQUIRES_NEW. 
You use these constants to allocate an object to a synchronization 
domain relative to its creating client: 

//C# 

[ Synch ron i zati on (Synch roni zationAttri bute.REQUIRES_NEW)] 

public class MyClass : ContextBoundObject 

{) 

The default constructor of the SynchronizationAttribute class 
uses REQUIRED. .NET gives you three options. First, you can 
place an object in its creator's synchronization domain, in which 
case the object shares a lock with its creator. Second, you can place 
an object in a new synchronization domain, where the object has its 
own lock and starts a new synchronization domain. Finally, you can 
choose to not place the object in a synchronization domain, in 
which case you get concurrent access and no lock. 

Pici< a Sync Domain 

.NET determines an object's synchronization domain at creation 
time, based on the synchronization domain of its creator and the 
constant value you choose for the Synchronization attribute (see 
Table 1). That's because .NET uses a heuristic, which assumes 



Synchronization 
constant flag 



Does the object's creator have a 
syachronization domain? 



Synchronization domain 
determined by .NET 



NOT SUPPORTED 




SUPPORTED 


Yes 


SUPPORTED 


No 


REQUIRED 


Yes 


REQUIRED 


No 


REQUIRES NEW 





The object will never be part of a synchronization domain, regardless of 
whether its creator has a synchronization domain. 

.NET places the object in its creator's synchronization domain. 

The newly created object doesn't have a synchronization domain. 

.NET puts the object in its creator's synchronization domain. 

.NET creates a new synchronization domain for the object. 

.NET creates a new synchronization domain for the object, regardless of 
whether its ereator has a : 



Table 1 Determine Your Object's Synchronization Domain. .NET determines an object's synchronization domain at creation time, based 
on the synchronization domain of its creator and the constant value you provide for the Synchronization attribute. REQUIRED is the default for 
the Synchronization Attribute class. 
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Figure 3 Share a Lock With the Creator. Determine whether your 

object requires a new synchronization domain based on the calling 

pattern to your object. Consider this calling pattern, in which you con- 
figure Object2 with synchronization set to REQUIRED, and you place 
it in the same synchronization domain as its creator, Objecti . Sharing 
the lock with the creator when the two objects don't interact causes 
Client B to wait until the first call is completed, even though it could 
access the object safely. 

that calling patterns, interactions, and synchronization needs 
between objects usually resemble the relationship between an 
object and its creator. 

The various Synchronization attribute construction values give 
you a variety of options. An object with synchronization set to 
NOT_SUPPORTED never participates in a synchronization do- 
main. The object must provide its own synchronization mecha- 
nism. Use this setting only if you expect concurrent access, and you 
want to provide yoiu' own synchronization mechanisms. But why 
do that? Contest-boimd objects should leverage .NET's compo- 
nent services support. 

An object with synchronization set to SUPPORTED shares its 
creator's synchronization domain if it has one, and has no synchro- 
nization of its own if the creator doesn't have one. Use SUP- 
PORTED for the rare case when the component itself has no need 
for synchronization, but downstream objects it creates do require it. 
Components with synchronization SUPPORTED can propagate 
the synchronization domain of their creating client to downstream 
objects, which then share one synchronization domain instead of 
having separate ones. This reduces the likelihood of deadlocks. 

You most often set object synchronization to REQUIRED — - 
that's why it's the SynchronizationAttribute class default. Always 
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Creator's synchronization domain 



Objectl 



Client B 



Object2 
REQUIRES_NEW 



New synchronization domain 



Figure 4 Start a New Synchronization Domain. In this calling pat- 
tern, having a synchronization domain separate from the created ob- 
ject enables the object to service its clients more efficiently. Using 
class factories to create objects provides a classic example of needing 
to configure components to require a new synchronization domain. 



use this setting if you don't care about having your objects in a 
separate synchronization domain. Sometimes, however, you'll want 
to start a new domain. 

Base your decision on whether your object requires a new 
synchronization domain on the calling pattern to your object. 
Consider a calling pattern in which you configure Object! with 
synchronization set to REQUIRED, and you place it in the same 
synchronization domain as its creator, Objecti (see Figure 3). In 
this example, the two objects don't interact past the point of 
creation. While Client A is accessing Objecti , along comes Client B 
on another thread, and it wants to call methods on Object2. 
However, because Client B uses a different thread, .NET blocks it, 
even though it could have accessed Object2 safely, because it 
doesn't violate the synchronization requirement for the creating 
object, Objecti. 

Class Factories Need New Domains 

On the other hand, if you were to configure Object2 to require its 
own synchronization domain by using REQUIRES_NEW, the 
object could process calls from other clients at the same time as 
Objecti (see Figure 4). Using class factories to create objects 
provides a classic example of needing to configure components to 
require a new synchronization domain. 

Class factories usually require thread safety because they service 
multiple dients. Once a factory creates an object, though, it hands 
the object back to a client and has nothing more to do with it. You 
need to configure the objects to require a new synchronization 
domain because you don't want all the objects created by a class 
factory to share the same synchronization domain. 

However, calls from the creator object (Object 1 ) to Object2 will 
now potentially block and will be more expensive because the calls 
must cross context boundaries and pay the overhead of trying to 
acquire the lock. You can synchronize context-bound objects most 
easily using .NET synchronization domains. These provide a mod- 
ern synchronization technique that formally eUminates many syn- 
chronization problems and the consequent need to code around 
them, then test the handcrafted solution. 

Synchronization domains provide a substantial productivity 
gain, but you do need to consider four limitations. First, you can use 
synchronization domains only with context-bound objects. All 
other .NET types require manual synchronization objects. Second, 
you could have performance issues when you access context-bound 
objects using proxies and interceptors in an intense calling pattern. 
Third, synchronization domains don't protect static class members 
and static methods. Those require manual synchronization objects. 
Finally, synchronization domains are not throughput-oriented. An 
incoming thread locks a set of objects even if it interacts with only 
one. This precludes other threads from accessing these objects, and 
theoretically could degrade application throughput. 

For balance, you must rely on synchronization domains and 
other advanced component services in any decent-sized applica- 
tion — or whenever productivity and quality are top priorities. 



Juval Lowy is a software architect and principal of IDesign, a 
consulting and training company focused on .NET. This article 
derives from his upcoming book on programming .NET components 

(O'Reilly). Juval speaks at development conferences and chairs the 
.NET California Bay Area User Group's program committee. Contact 
him at www.idesign.net. 
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Got an Advanced Degree? 




Find out how much it^ worth. 

2002 Visual Studio Marine Salary Survey 

Exclusively on www.visualsludiomagazineaCom 



FfPOnline 
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The alternative to mail merge 

• Designer fully integrated with MS Word 

• Robust ActiveX component for 
producing customized documents 

More than just mail merge 

• Easily control ttie document layout ■ 
with VBScript expressions 

Access any data source 

• Use ADO, ODBC, DAO or even XML to 
access one or many data sources 



To advertise in tin is 
Showcase section, please 
contact Katrina Cepeda 

650.833.7109 
kcepeda @ fawcette.com 

Call Today to Reserve 
Your Space! 

Visual Studiv 



Accounting Source Code 

Integral Accounting Basic VB is a 
full featured Accounting System 
that includes OE, Inventory, AP, 
AR, GL, Payroll, and Source Code 

written in VB 6.0. Printed and 
electronic documentation are also 
included. To download a demo, 
please visit www.stfb.com 

(Access & SQL Versions also 

avaUable) gfpg 

Pff; (954) 986-8917 
http://www. stfb. com 



Technologies I 

el; 509-691-2839 





Barcode TrueType Fonts & SDK 

Code39, Code128, Code93, CodaBar, ITF, MSI, UPC, 
EAN, UCC/EAN, FIM., RSS, PostNet, PDF417, 
DataMatrix, MaxiCode. 

Output to direct device context, WMF, BMP, BMP and 
TIF. Integrate to VB, Access, Crystal Report, C/C++, 
Delphi, QuickReport, Oracle Report. Free full-featured 
trial domiload available from web. 

Barcode Equipments 

Laser & CCD barcode scanner, image reader, barcode 

' ' I ' ' r ^^-:h drawer & many more- 



Compile web sites, ASP applications and 
catalogs into a single EXE flle. Produces 
EXE with integrated ASP-conq^atihle web 
servo-. Setup 01^ data sources and 
external COM components. 

WEBSvr/ASP component 

ASP-compatible web server in a DLL. 
Includes SSL, PNG capturing engine, 
PHP/ISAPL multithreaded engine and more. 

OctoGroup.NET 

www.octogroup.net 

our sjic for a free demo 



CAD & Graf 



phics Libraries for Developer ; 



Easily add prof 
bar coding 
to Window's appli 
in minutes. High-quality 
device-it>dependent bar 
codes. Not fonts! Not 
bitmaps! Perfect for VB, 
C++, Access, Excel, Word 
and Internet Explorer. 
Supports data binding. 
Prints all major bar code 
types — including 2-D. 
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minutes you can add CAD functionality 
to your programs; read, display, create 
and manage 2D & 3D drawings. 

Simplicity and solidity on VisualStudio 
6 & .NET, Delphi, C++ Builder & HTML. 
Fully object oriented components. 

DWG DXF ENF WMF VDF VDI TIF BMP GIF JPG 



ImageKitS and ResizeKit 

The ImageKitS add^s image-processing capabilities 
to your applications. Includes Display, Effect, File, 
I^rint, Scan, Slideshow, and Thimibnail Controls 
with over 110 functions. 

I he ResizeKit automatically makes your 
applications size and resolution independent No 
coding necessary. Contains both ActiveX and VCL 

controls. 
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Need Hands-On 
Technical Info? 

FTPOnline— the new 

network of tectinical sites for IT 
development professionals. 



• Downloadable code 

• Interviews witf) industry experts 
and visionaries 

• Overviews of the newest 

technologies 

• Links to other hotspots on the 

Web 

• FREE! Thousands of pages of 
archives and articles 

• Plus, FREE weel(iy e-newsletters 
in your area of interest 

www.thedotnetmag.com 

www.visualstudiomagi^^eom 

www.javapro.com 

www.xml-mag.com 



SERIAL COMMUNICATIONS 

Sax.net provides mission-criticol 
communications when failure is not an option. 
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■"Sax.net 

www.Sax.net • lnfo@Sax.net • 800-645-3729 



8 Cool Controls! 

TE Edit Control Advanced RTF control 
HTML Viewer/Editor Add-on for TE 
SpellTime DLL and dictionary 

RTF Code Generator 
ReportEase Plus report writer engine 
Form Plus 
Rich Text Grid 
ChartPro 

Sub Sy^um, tie. 
TELE: (S12)733-2S2S FAX: ^12)733-2204 

Demos: www.subsystems.com 



You Tired of Paying Royalties? 

SKYUNE TOOLS IMAGING PRODUCTS 
Royalty Free Products 

• CORPORATE SUTTE ACTIVE X 
Document and Color Imaging 

Cohr and Document Inu^^Padx^e Witt) Source 

• XMAGEUB BARCODE SUITE 
Barcode Reader 

• XMAGEUB OMR TOOLKIT 

• VTOEOIIBOCX 
VideoCapture 

• DOC-TO-NET 

Internet Imaging 

Send documents over Mem^ 



Free Trial Downloads: 

www.iniaeelib.com 
Phone:(818)3464200 
email: sales®iniagelib.com 




Spell-Checking 
ActiveX Control 



Speniext is a g|3saa|tDal to 
use in your nraiectts. 

There's no easier way to help 
your users check theii' spelling 
Aanlthis'' 




Data Compression 



Add zip compression to all 
your Windows programs. 



free full evaluation copies 
www.innerniedia.com 



dynaZip 



CM 



\ ActiveDellvery' 



Deliver custom content 
from automated web sites. 




SpellText works like a normal text box, 
automatically checking spelling. 

• Rated A+ by Foxpro Adrisor 3/2000 

• Built-in dictionary of 113,000 words 

• Handles any size custom dictioriaries 

• Red wavy lines under all misspellings 

• Completely customizable 

• OCX is only 800K in size 

• Includes an Internet-ready CAB file 

• Royalty free, with lifetiine free support 
Download an evaluation copy today! 

ON THf: WEB SINCE 1 996 

http://www.chado-software,com 



Self-extracting Zip 



Resize 

Resize gives your applications resolution 
independence. ReSize alters the sizes, font 
sizes, and positions of controls on Visual 
Basic forms as they are sized without 
requiring you to write code. ReSize will give 
your applications a more professional 
appearance and allow them to run on a full 
range of display devices. 
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ASP.NET Basics 



• 13 Hours of Irainng 

• 6 CD's or videos 

• 512 page printed course manual 
■ Exercises, review questions 



ASP.NET Architecture 

Only $299.95 
• SCDtorvldeos 



• Downloadable cods 
ASP.NET Advanced 

• 13 Hours of trainng 

• 6 CD's or videos 

• 430 page printed course manual 

• Review exercises, questions 
and answers 

• Downloadable code 

Both ASl' courses SS'W.O? 




For a limited time! 
all five sets only 

$1,999.95 

$»e$300 



' 6 CD's or videos 

• Printed course manual 

• Review exercises 

• Downloadable Code 

• Ask about advanced 

Database Dev. 
Wtth.NEr 

Only S499.95 

• 6 CD's or videos 

• Printed course mamjal 

• Review exercises 

• Sample Code 

• More... 

'Avallibtt In August 



• 30-(lay motley 
back-guranlee 



• Ro;il',worli1 luiinintj 
rnRlhodolgv 



• Fits your schedulf 



• Available on CD 
or video 



CrypKey™ 

Battle-Proven Software Protection 

since 1992 



^ new XP support 
^ best LAN/WAN support 
^ auto Unlock Server 



New Version 6.0 



SaveTime& Money! 
Free White Papers 

http://crypkey.com Tel: 1-403-258-6274 



Schedule, Archive, & Distribute 
your Crystal Reports 
via Email, Fax, File, & Print 



Information Distribuibn 
Manager (IDM) 



I 



The perfect add-on to enhance the value 
and functionality of your current systems 



www.goodalesystems.com 

or call (310) 768-3968 

goodale systems, inc. 



Introducing .NET Insight UemleUer 



Delivered to Your Inbox Every Week. 



is going to be huge — and we're mailing 
it easy for you to iceep up witii it. 

Sign up for the .NET Insight newsletter, and every week we'll send you timely 
and relevant information about integrating .Net and technologies like XML, 
SOAP, SQL Server, Visual Studio .Net, and more. You tell us how much or how 
little information you want, we wrap it up and send it to you. Every week. 



Free newsletter: sign up today! 
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To our customers: Thanks for making IBM the world leader in database software. How did this happen? 
By providing performance and value across platforms including UNIXf Windows* and Linuxf The leading 

application providers: J.D Edwards, PeopleSoft and SAP ail agree. DB2 is how you win the game of e-business. 
DB2. Part of our software team including Lotusf Tivoii* and WebSphere? For more, visit ibm.com/db2/sNin 

(e) business is ttie game. Play to win." 



Pick Leaders 
Who Can Help You 



The Visual Basic community has been in turmoil since the 
announcement of .NET in 2000. Listening to the .NET vs. 
.NOT debates has prompted me to think about leadership 
and the qualities leaders share. Basically, leaders are a part of so- 
lutions. Leaders help with the hard work of navigating choices, 
but they don't make the choices for us — choices such as deciding 
whether .NET is a technology that can help you produce high- 
quality appUcations quickly. 

Leaders help us find our way though a deluge of ideas and 
concepts — especially when we're faced with a dramatic debut like 
that of .NET. Leaders map out a ditection through the technol- 
ogy. They don't prescribe a destination. They don't proscribe 
one either. They lessen anxiety, rather than increase it. They 
aren't secretive or mysterious. Their conmiunications have a high 
signal-to-noise ratio, so it's easy to get at the substantive bits of 
what they have to say. 

The best leaders become leaders by going about their busi- 
ness, which looks something like our business. But they take the 
time to share their experience with us so that our way is clearer. 
That means leaders have to be wiUing to go on record. They have 
to risk airing their opinion. Most of us are opinionated, but not 
many ot us are articulate or care to speak publicly. 

Leaders are influential. I've been a developer for 1 5 years and 
an MVP for four. I'm lucky to belong to a tight-knit (if some- 
times fractious) community. Over the years, I've seen some tre- 
mendous leaders rise from the developer ranks. They consistently 
and significantly influence the ditection of a tool. Because of 
their influence, I have a different experience using programming 
tools than if they hadn't contributed. I consider particular meth- 
odologies and technologies because of their influence. 

In order to have influence, leaders must be involved in the 
early stages of development. Even if they aren't early adopters, 
they must be early users. They have to be willing to suffer fre- 
quent, and frequently fatal, bugs. Leaders grit their teeth while 
reformatting a system between versions. Leaders are writers and 
editors. They critique documentation that might be, at best, out 
of date with the sofirware. Leaders are testers. They must have a 
clear vision of what the tool should be able to do, what it is in 
fact doing, and how it might be done better. Leaders are master- 
fill debu^ers. They perform triage that helps the vendor iden- 
tify, locate, and either fix or explain the behavior. Leaders try al- 
ternative appioaches and attempt to identify workaroimds. They 
create simplified scenarios that dupUcate the problem. They write 




detailed bug reports and other- 
wise help the development team 
track down the source of prob- 
lems. They must be able to 
communicate deaily. In part, 
they must be psychologists. 

Leadets continually study 
and absorb information related 
to their profession. Specifically, 
they should have experience in 
more than one language so they 
can have perspective on how 
different languages implement 
computer-science concepts. 
They are practitioners of good 
coding practices. It isn't enough 
to know all the tricks and tics 
of a language. A significant por- 
tion of software development is 
spent maintaining software. If 
you've ever inherited an appli- 
cation from anothet program- 
mer, you know how hard it can be to tease out clever but obscure 
intent. We look to guidance from leaders not only on how to use 
technology, but on how best to use it and how to avoid pitfalls. 
In otdet to advise us on the best use of a technology, leaders are 
experienced in several application domains so they can assess how 
broadly usefiJ a tool might be — ^not just for their specialty, but 
fof the test of us. 

Given all this intensive work, we expect leaders to be among 
the people writing books, atticles, white papers, and third-party 
add-ons that make using .NET easier for us. They should volun- 
teer significant amounts of time on the online forums, helping 
the commimity imderstand the technology well enough to liiake 
informed choices based on a given situation. 

The Tao de Ching says a good leader leads the people where 
they want to go. That's what I'm looking for as a developer. 
How about you? 



Discuss this opinion in the 
VB.NET forum on our Web 
site. Use this Locator+ 
code: VS0209GO_D 

The opinions expressed 
in this editorial are those of 
the author and not neces- 
sarily the opinions of VSM. 



Nancy Folsom is a Visual FoxPro developer, Microsoft MVP. wmat 
of Pixel Dust Industries, and author of Debugging Visual FoxPro 
Applications (Hentzenwerke Corp.). Reach her at nancy® 
pixeldustindustries.com. 
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Winning in the future: eBay has cracked the code of e-business success: keep the customers coming back for 
more. But how can they more than triple sales by 2005? WebSphere. It's helping eBay slash the time it takes to 
build and deploy applications, thanks to a tightly integrated runtime infrastructure and development environment. 
Plus, it's based on J2EE and supports the latest Web services standards, so it can help get your applications out 
the door faster, too. WebSphere. Part of our winning software team, along with DB2f Lotus® and Tivoiif Find out more 
and get a free trial download of the WebSphere Studio Application Developer at ibm.com/websphere/ebaydev 




Mirrored Charting - For Win & Web! 



infragistics - formed by the merger of Sheridan and ProtoView 



Infragistics is proud to announce our newest presentation-layer offering - Charting for 
Windows Forms (Visual Studio.NET) and Web Forms (ASP.NET). UltraWinChart and 

UltraWebChart share the same object model, and both provide the same rich look-and- 
feel of a superior client-side control. Present quantitative and categorical information 
visually and with unprecedented ease. We've provided a comprehensive selection of 
contextual RAD design-time features, a rich event model, and elegant aesthetic 
enhancements. Chart data has never before been so exciting, polished and professional. 

UltraWinChartVUItraWebCharr 

■ 2D/3D Chart types - All major chart types are available including Bar, Column, 
Line, Area, Pie, Scatter, Bubble, HeatMap, HiLow, Financial and Candle Chart. 

■ Intelligent Rendering - Experience maximum productivity and usability through 
our exclusive IntelliRend™. We've built in every conceivable convenience, intuitive 
design considerations, and advanced developer control Into our Charts. Look for 
this mark to identify a feature that saves you time, effort and code! 

■ Data bound and non-bound modes - We provide seamless integration with .NET 
data sources and containers. Populate your chart from a database or array, using 

the DataSource property. Internal filtering ensures the data model supplied matches 
the chart type chosen. IVIanually exclude/include data columns and rows." 

■ Robust Aesthetic Enhancements - Charting is really about how your data looks. 

Make your chart visibly superior with anti-aliasing, alpha blending, transparency", 
background images, an advanced Color Model , and an innovative layered design. 

■ Advanced Security*^ - Our exclusive, non-visual component, SecurelmagePipe™, 
provides ASRNET session based security for protecting rendered chart data. 

■ Event Handling""' - Our exclusive Activelmages™ generates the scripts needed for 
client and server-side event delegation, seamlessly and accurately." 

■ Attention to Detail - RAD design-time configuration, automatic 

data scaling" & congestion control, data highlighting™'", advanced 
tooltips, fully customizable legends and labels , printing and more! 
"= UltraWebChart only •"" UltraWinChart only IntelliRend Technology 

Copyiis^ 2002 InliiiglstlES, Inc. Al rights te5eivedlnfragrstics,lheMaglstics logo. 



O 2D Bar Chart 

® Advanced ToolTip (image 
rendered In tooltip)'""^' 

O Candle Chart 

O Chart Legend 

© 2D Pie Chart 

O Formatted Chart Labels'" 

O Bubble Chart 

Layered Transparency 

of Chart elements'" 

O Contextual RAD (Design- 
time) Properties" 

Transparency Editor 



UltraWinChart & UltraWebChart 

are now available in 
NetAdvantage™ Suite 1 .2 

For detailed information: 
www.infragistics.com 

Download Free Trial Version! 

Order Online! 

or call 800-231-8588 
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Component powered infrastructure 

UltidMnOian, NetAdtontage Suite, SecuchBgd^ 



, .UtreMttChaitUlti^ . , , 

othe^oademaria (»- neglsteied tradeniailG are the lespedhc prapeily of thfe^ 



Java • ActiveX • .NET 800-231-8588 » mfragistics.com 



